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NOTICE: 



The content of this manual obtained from f)CS may differ from the 
on-line version. The on-line version reflects exactly the SES tool 
set installed on your development machine at your site* whereas the 
DCS version describes the full SES tool set and all available 
options. 
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1.0 £a£M££ 



This manuat describes the procedural user Iriterface to alt of the 
Software Engineering SysteiB (SES) Usabll i ty Tool s under the five 
product packages listed below; 

1* Mfll-IliaiSA This is the core set of SH5 tools and is required by 

the other four packages* This set of tools Is sometimes 

referred to in this manual (and others) as the 170 SES tools* 

SES tools or simply SES. All SES procedures that are not 

Included in the other four packages are Included in this one. 

2* LIlIL~12!^-Q.filiJ£«^£G££.lia!:x This product Is also referred to as 
CY8Ii-CC. The SES procedures In this package are CYBIt, 
CYBEORH, GETCQHN, SETCCDB and GETLI8. 

3* £XMi-£=CaxJ£-£SfiS£lla£A This product Is also referred to as 
CYBIL-CP. The SES procedures listed for CYBIl-CC plus all of 
the procedures described In the SES Object Code Utilities 
chapter and the UCSD P-Code EnvironraeTt chapter in this fnanual • 

^« M05«-.S££ill£A This product package consists of the data 
dictionary utilities described In the Structured Process Tools 
chapter. It Is sometiiaes referred to as CADS OD. 

5. ttai^ElEaA This product package Is also called CAOSG or CAOS 
Graphics and consists of the SES interfaces CADSG and CAOSGEDIT 
described in the Structured Process Tools chapter. 

6. UQi-CtlAElA This product package cc^slsts of the CY8IL to 
structure chart tools described in the Structured Process Tools 
chapter • 

7* L12Qli£I«iUfifia£i«Iafli5* This product Is also referred to as 
Network Tools. These tools provide « Motorola f1C68000 

development environment on a CYBER 170. 

Each of these product packages can be ordered separately from 
Control Data and can be Installed in any combination which includes 
the NOS Tools package. 
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la lliIEOfly£IlQI:i 



^irlan D« Hilis 



The Software Engineering System (SES) prbyldes task orlefited or 
procedurat access to a coHection of iaftllLSllilllSl* running on the 
Network Operating System (NOS). An underlying philosophy of SES 
Is t where there's a function or task to be done* provide a 
PROCEDURE to do I t« Programs are general ty not used directly* 
rather they are accessed via SES procedures that provide a 
consistent access method* 

This SES User's Handbook Is Intended both as a tutorial 
Introduction for new SES users <who should dafiaiifiil read this 
chapter)* and also as a reference manual for' experienced SES users* 
Although this is not the qqI^ existing relevant SES docuJiient* It's 
the main trunk of the tree of knowledge of abai SiS* ££Qli£Iiy£IS are 
available* This SES User's Handbook Is usually updated only at SES 
Rel eases* 

IStttM^tS. ££fiiJy£ilfiIl covers many areas other than the narrow 
fields of "assemblers* compilers and loaders"* To cover the wider 
areas* we nee6 good tools* SES provides the tools*^ This SES User's 
Handbook is arranged In chapters that **cluster*» around related 
functional areas (such as document formatting* file management* text 
processing and so on)* This chapter is a general Introduction to 
the concepts of SES and Its use* The regaining chapters of this 
handbook cover the functional areas* Below Is a brief summary of 
the contents of the remaining chapters* 

A major proportion of SES Is devoted to the CYBER 180 SIMULATED 
ENVIRONMENT* running on the CYBER 170* The chaoter called 'CY8ER 
180 Virtual Environment Creation and Simulation' contains 
information on building the virtual envi r onifient* simulating* and 
transferring text files back and forth between the CYBER 180 and 
CYBER 170* The chapter on *CY8ER IBO Object Code Ut i 1 1 ti es' 
describes the CYBER 180 OBJECT CODE UTILITY* used to manage CYBER 
180 Object Text* One of CYBER ISO's significant differences from 
CYBER 170 is the use of real eight-bit ASGCT* NOS runs on a six-bit 
oriented system* and provides only partial support of ASCII* SES 
provides extensive support for ASCII* The CYBIL comol I er Is ASCII 
oriented* as is the CYBIL formatter* the documentation facilities* 
many of the text manipulation tools* and the source text maintenance 
util ities* 

Of course* Compilers* Assemblers and Loaders da P^^Y a part in 
software production - the chapter called 'Compiling* Linking and 
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Debugging' covers a lot of useful tools in this area* Included in 
this chapter is the CYBER IHPIEMEHTATION L4NSIJ4GE - CY8II. As well 
as a CYBIt cofnpMer> this chapter also describes CY8Ii-CC 
INTERACTIVE DEBUG, a sysiboMc debug facility, based on CYBER 
Interactive Debug but oriented towards CYBIL code. 

Production of large lor small) software systems requires some 
means of HANAGING SOURCE TEXT to avoid a lot of detail work. SES 
supplies a comprehensive collection of source text nsaintenance 
procedures geared up for the ASCII version of HODIFY {known as 
HAOIFY) to jnanage ASCII source text for yout or* In fact, any other 
ASCII text, such as docuJRents, data dictionaries, process 
descriptions and so on. These facilities are described in the 
chapter called 'Source Text Maintenance. The chapter entitled 
•Source Code Utility on NOS 170* describes the NOS-170 version of 
the CYBER 180 Source Code Utility CSC J). There's also a set of 
procedures to make UPDATE easier to llye with, described In 
'Handling Update Program Libraries'. 

When you've compiled or assembled your source text of course 
there's the question of OBJECT CODE MANAGEMENT. The chapter on 
'Library Or Multi Record File Hanagefiieit Using LI8EDIT' covers 
LIBRARY HANAGEMENT ~ a collection of procedures that interface to 
the NOS LI8EDIT utility. These library management procedures can in 
fact handle things other than object code. 

One of the first hurdles to clear on most computer systems seems 
to involve the question ••how do I print a file"? The chapter on 
'Printing Files' shows that printing files really can be easy* 

An important part of software production involves OOCUHENTATION. 
SES has a collection of tools that make a fun job of generating 
beautiful documents. Documentation aids revolve around the TXTCOOE 
document formatter, used to produce this Handbook. The 'Document 
Formatting System' chapter covers document formatting. 

preparing beautifully formatted source text for high level 

language processors Is something you like to have, but you'd rather 

not do It yourself. Various types of prepr'ocessors are covered in 
the chapter on 'Source Text Preprocessors' .t 

In any time sharing system, MANAGING FILFS Is an important part 
of life, as is FINDING OUT WHAT'S GOING ON. 'Getting Information' 
relates to getting information, such as your files, ltmits» dayflle, 
while the chapter on 'Filespace Management' covers the aspect of 
dumping your files to tape, and hanging on to files vou want to hang 
on to. 

An amazing amount of the daily job of software production 
involves massaging text in some way or another. 'Text Hanipulatlon 
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and Conversion Utilities' covers roany aspects of TEXT HAHIPULATION. 
Conversion of character sets tends to be a way of life rather t*ian 
an infrequent exerciser and there are ytiffties to work well with 
the NOS version of ASCII* 

Software Production really is a comi!?iinity activity* and *SES 
CoinfRuni cat i ons* describes facilities for user's to talk to each other 
via a mal I system. 

SES PROCEDURES take care of the details of usinci softitaret such 
as locating* returning and rewinding fifes* obtaining required 
memory* obtaining required utility programs to perform tasks* and so 
on* leaving you free to specify what you want done. To state it 
briefly J 

YOU decide WHICH SES PROCEDURE you want to use for the job, 

SES generates the JOB CONTROL STATEHEMTS to do the Job. 

Using SES* you can run a procedure directly as part of your 
interactive session* or you can make many of the procedures run 
independently as batch Jobs. 

Experienced or curious users wishing to create their own SES 
procedures can read the SES Procedure Wrlter'^s Sulde. 

At the end of this chapter there's a list of documents relevant 
to peaceful and productive coexistence with NOS.* 

As you read this document* you* If notice that although many SES 
procedures have lots of parameters* most parameters are optional. 
For example* the PRINT and FORHAT procedures have* respectively* ten 
and eighteen parameters* 90% of PRINT And FCIR?1AT usage requires only 
one parameter. Finally* the MiJlJ2liit^ ^^ SES results from people 
using It and feeding back their (constructive) criticisms* ideas for 
enhancements to existing facilities and Ideas for new facilities. 
We hope you Ml do the same. 

M&ifi • We strongly recommend that you read all of this 
introductory chapter before reading other' chapters. As you read 
this introduction* try using some of the SES procedures described in 
the examples as you go. Finally : 

When all else falls* read the documentation! 
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l.l.l USING AH SES PROCEDURE 

Whether you use SES Ifiteractl vel y> or rUn It in a batch job* the 
usage is the sawet as shown here J 

sesaprocedure^nane I ist^of. parameters 

the ses before the period starts the SES processor*. The s,&tL^^ ^*^ 
following ^SiS »s ££ailiC£ll to keep NOS happy. The statement directs 
the SES processor to locate the procedure gfvan by procedure.namey 
and when it has been located* to procfss that procedure and 
substitute the foptionaU parameters giy^r» by 1 1 s t^of^par aaieters* 
and finally* execute the procedure either directly <*'while you 
wait") as part of your interactive session* or SUBHIT the procedure 
as an independent job* For example 5 

ses«prlnt bllvet 

PRINTS file bllvet on the ASCII printer* and s 

ses. count lines in grtind^e 

COUNTS the number of lines In file grundge. 



1.1.2 PARAHETERS FOR SES PROCEDURES 

As mentioned above* you use an SES procedure by typing a 
statement of the form s 

ses.pr ocedure^name I I st.of.par ameter s 

where I i s t^of.par ameters is the parameters re<iuired for that 
particular procedure. 

Parameters may be specified by !sfiXitfi£j|» for exanole s 

ses.pfint f»iiiyfHe 

In this example* f is the parameter Jssiiiscd ^^ parameter QjffiS* and 
myfile is the parameter iBlufi* Generally* the name on the left of 
the equal sign is the parameter JiStMStLSi or parameter ujofi* while the 
thing on the right of the equal sign is the parameter jta|.jifi« 
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While parafseters may be specifietJ by key^iofd* lt*s also possible 
<and usually more convenient) to leave out the keyword and the equal 
sign and specify parameters ansltlaajill* This iseans that you don't 
have to type the keyword or the equal sign»i For exaiiiple 5 

ses.copyacr Inflle* outfMfe* 3«»79 

When keywords are used* it doesn't matter I fi what or der you code the 
parameters. The use of CQPYACR above could have been coded « 

ses«copyacr o«outfilef 3».79» f»lnflle 

however If you want to code parameters without using keywords* you 
must get them in the right order* 

When you use an SES procedure you can code parameters in a 
mixture of both positional ^qiI keyword for^ns* whatever suits you* 

Every SES procedure expects Its parameters In a specific order* 
When you code a parameter by keyword* you effectively "tab** the 
parameter number to that "posi t i on*** That's why* In the example 
above* we were able to code * 

O'outfile* 3**79 

by coding o«outflle we "tabbed" the oara'setep' to the second 
'•position"* The next parameter (coded without the keywordi was 
already In the third "position"* But when we wanted to code the 
input file name we had to specify It by keyword In order to "tab" 
back to the first parameter position* 

Use of positional parameters sometimes leads to minor problems 
when what you think Is a file name is In fact the keyword for a 
parameter* For example* many SES procedures haye a parameter called 
group* which is the name of a group (or multl record) file* If you 
use a procedure such as COLLECT* for instance* like this ? 

ses*coliect (torn* dick* harry) group 

**£ CL llOOl: EXPECTING "value(s) for parameter GROUP" ON 

COHMAND STATEMENT 

In this case* the error message actually neans ? you have coded a 

parameter k&l^SlL^* ^^^ ^ot supplied a £al'i2 for* that parameter* In 

such cases* you have to fiitbfit code group«gr otip* a£ code the 
positional value In string quotes s «group^«^ 

Most SES procedures use short names like I and f for parameter 
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keynordsf so it's best if you avoid single fetter filenames* For 
example : 

ses.uptolon f 

will cause an error* because f is one of the key»«ords for the first 
parameter of UPTQLOW* You can either code the parameter as f«f» or 
code i t as *f*f or use a name like grab or Junk for' the filename. 
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1 • 1 • a • 1 Il£££S.il£.£j£^l£tS£.3^ JiM££ 

Values supplied for parameters way be Qai5Si.-ia3¥-Baifi5iL-i31llli££Si. 
or QhMLMSct&L liCXQSS* These are described in detail here» 



1.1. 2.1 a ||M£i-M«MEAII£II£.Miy£S 

A MM£ is from one to seven characters long. It iMS.i start with 
a letter* and may contain UQil letters or dlqits* For exaiaple 5 

A# ZQ91AP6> and FItEA are valid names* whereas ? 1AJ» input^flle* 
and overs! zednane are Invalid names according to the rules above. 
An example of using names In an SES proced'jre Is ? 

ses«uptolow l«hibroiij o'l(>vfbrdH 

for converting file hibroM frons upper case to lower* case with the 
result appearing on file loiibrow. 



1.1.2.1.2 Latia-Iiifl£i-.li-.£M4i£I£E.5i ALUEi 

A LOIiS-.Mtt£ is from one to 31 characters lonci. It imsI start 
with a letter* and may contain letters* digits and the special 
characters » #* $* .* 3. Any valid liM£ Is also a valid iQM^«MiE£* 
as are Input^file and oversi dednaroe. 



1.1.2.1.3 liyillM£5-.i5-£ARAIl£I£E-:S^ALy£l 

A !illllfi£B contains uulx digits. The nufnber may be followed by an 
optional BASE. For example : 

579C10) 1493 are DECIMAL SJHBF^S* or numbers to the 

base 10. 

677(81 1754(8) are OCTAL NUMBERS* or numbers to the 

base 8. 

0AF6(16) 3E8(16> are HEXADECIMAL NUMBERS* or numbers to 

the base 16. Mote that hexadecimal 

numbers liisi begin with a decimal 

digit* even If you have to start them 

with a zero. This avoids a potential 

confusion of a hexadecimal number with 
a name. 
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Numbers such as 6789{8) Bn4 3ASC10I are disliked by SES* Use of 
numeric parameters occur in procedures like t 

ses.pr Int copies»3# f«yfnyang 

to print three <3) copies of file ylnyang ofi the ASCII printer. 



1.1.2.1.4 £M£A£I£E.SI£iMSI-ii.£^EAI3f I£E-!iiillII 

A CUMiCIIS SI£I(!i£ is any arbitrary string of characters enclosed 
in single quote signs («)* If you wish to include a single quote 
sign in a string* you must represent it by two quote signs in a row. 
For example s 

•this Is an example of a character string* 

* quote signs isust be represented by two ** quote signs in a roM* 

You use strings in SES procedures when you have to supply strange 
names such as SYHSSM* and when supplying sentences to procedures 5 

ses.genupcf d«»iics$c30' 

when generating an update compile filet and 5 

ses. i inkl70 binf I ie» xl d«*idsetlusep«SMisys*subst«swlsy-$SMt $y«l$}< 

to give extra loader directives to LINK170. 
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Some SES procedures handle parameter values In the form of a 
E4li^£* fo*" Instance* procedure CQPYACR has a parameter named cols# 
which represents a pair of column numbers. fou can write the cols 
paraiseter in the form s 

C0ls«3««65 

the pair of periods Is called an ELLIPSIS. Th*? range specification 
consists of a IflM sliifi' on the left of the ellipsis* and a hLSih SliJ£ 
on the right of the ellipsis* Another e^onple of a procedure that 
accepts ranges is GENCOMP* which accepts ranges of module nawesf 
like this i 

ses«gencoiip aiaiaden«*hertero 

which refers to all modules alnaden througfi bertero Inclusive* and * 

ses*select lines 10«*20 of galfoop 

to display lines 10 thru 20 of file galioop at the terminal* 
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1.1* 2« 3 iist5-af«Ealii£S-tii£-£a£Ji£i££s 

Sorae SES procedures handle parameters cor^slsting of many values* 
For Instance* you can tell procedure PRINT to print a whole bunch of 
f i I es* like this t 

ses«print f=»latlas^ orient mcrcuryf pe<iasus> slrlus» hermes) 

the value coded for the f parameter Is called a OiHI ilil* A value 
list iMSi be enclosed in parentheses* as shown in the example* The 
individual items in a value list are called gLillMIl of the list* 
and they are separated from each other by a comma. 

Elements in a value list can also be ranges ? 

ses«select lines Clf 2$ 3f 12««17* 21..25) of widget 

An element of a value list may itself be another* value list* For 
instance* procedure GEHCOMP has a parameter called ab» which can be 
coded in the form i 

genconp ab»f frlesl i ng* iiiondayn» gamay* fehenlnf wenteH 

to get alternate bases from other user's catalogs* Note that the 
first and second elements In each of the subllsts are the filename 
and the users catalog namef respectively* The description of the 
GENCOHP procedure talks more about the ab parameter'* Also see the 
note belowy at the end of this description on parameter lists. 
Procedure ASQRT uses lists of lists to indicate the columns for the 
sort keys J 

ses.asort l«ganip# cganopy keyssffl* 9)> <4f If dll 

Each sublist in the list above Is a single sort key? the elements In 
the sublists are the start column* length* and direction of sort* 
See the description of the ASORT procedure for lore information. 

If you code only one value for a parameter* you can leave the 
parentheses off* like this : 

ses.pfint f^myfUe 

but as soon as you want to supply more than one value you must 
supply the parentheses* like this ? 

ses.print Cbowniore* Jura* mi I town) 
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Such are caHed liilii UlilfiSl fiatSlfiifiCl* or* xtlllfi lliJtS* or just 
plain lists. 

Referring to the discussion on the ab para^seter of GENCQNP above* 
a fen SES procedures handle parameters of that form* Those 
parameters are somewhat special forms for accessing files from other 
users* catalogs* for example* the LINKITO procedure uses this form 
for the list of libraries t 

ses. 1 1 nl<170 p«IC Hb,l# 1 1 b_2>us€r.ll>ll b_3*M lb_4* Hb_5>user_2) I 

each ^ififfisaJ; In the outer parenthesised list }s itself a list 
(possibly containing only one element) of libraries and the places 
to get them from. So* in this example* the ficst sub list says 2 
obtain llb.l and Mb«2 from the catalog of user.l; the s^^SBiJ 
sublist has only iias element* which mear^s t obtain llb^3 from the 
catalog of the current user* the iJjixd sublist says t obtain Hb.4 
and 1 1 b.5 from the catalog of user.2» For" procedures that use this 
form of parameter* the last element in each of the sublists Is the 
user name of the catalog from whence to obtain the files* 
Conversely s 



ses,llnkl70 p«Mlb.l* llb«2# ilb.3* f1b.]4* flb.5l 

means s obtain all five library files from the catalog of the 
current user* 
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Some SES procedures handle jaultl value?! paraieters which are 
themselves parameter lists to be passed on to other procedures. For 
instance^ procedure FORMAT has a parameter' calfed print* which Is 
actually the parameters for the PRINT proceduref used by FORMAT in 
the course of its run. You code the print oarapeter of FORMAT like 
this I 

ses»f ormat «yf I le> prl!it»c»2! 

ses.fornat hisfllef prlnt«Cc=5th»*flnaf ers«) 



1 • 1 • 2 • 5 £i£ ji£i££.E£^Ma£ii. Ji.£ta££jdii££-02 1 1 ao s 

Sofne SES procedures have parameters that don't want any values at 
all. In these cases^ the parameter IS^^MfiClS' 's used to Indicate 
0£IIQMi for the procedure. For instaicef procedure PRINT has a 
shift li£3c (no pun Intended)* which If coded* Indicates that the file 
to be printed has not been formatted for a line printer nnd must 
therefore be "shifted** to the right by 1 column and have carriage 
control characters added In <the new) first coluun. You use PRINT 
in such a case like i 

ses.print f«anyfilef shift 

and another example of options Is GENCGHP CGENerate COMPile filel* 
where you can type i 

ses.gencomp atiy b«cidbasef ef«comflfe 

in this case* the alt ii£x indicates that all modules are to appear 
on the resulting *»compile file**. 

Throughout the procedure descriptions* we use the word Ij^j^ to 
mean a keyword used to provide options to a procedure. 
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1»1,3 USING MORE THAN ONE SES PROCEDURE AT h TI^E 

It's possible to use many SES procedures* aach one following on 
right after the previoys ones with no execution breaks between theja. 
Toy do this by coding them all on the saie line* each procedyre 
terminated by a semicolon* like this s 

ses«print myfile* noshift; print hlsflle sNIfti catllst 

This €xa?aple PRINTs aiyflle and doesn't shift it (the noshift lisi)* 
PRINTS hlsflle with carriage control added (the shift fis^)* and 
finally does a CATLIST of your files for you* 



1.1.4 ORDINARY CONTROL STATEHENTS ON A CALL TO SES 

It's also possible to Include regular ^OS control statements on 
the same line as SES procedure calls* all mixed together* like 
this 5 

ses«print myfile; •return*iiiyf 1 1 e« ; *get*hlsfne'; format hlsflle 

As you can see* the ordinary NOS control state^nents are enclosed in 

string delimiters jyst like any other character string. When SES 

processes one of these control statemer^t strings* it follows the 
rule that s 

if the string doesn't contain a period or a close parenthesis* a 
period Is appended to the string* otherwise the string is left 
alone* 

This means that you can place NOS control statements such as GTR 
and MODIFY (which use the control statement comment field for 
directives) with no problems. For example s 

ses«'attach*plocrl b* ; •gtr*plocrlb*f red.i*» 5 print fred 

In this example* the second NOS control statement* namely the GTR* 
has a period In it* so SES doesn't place any period at the end of 
the string* whereas SES ilJ2£^ place a period at the end of the first 
string (the ATTACH statement). 
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1.1.5 CONTINUING SES STATEMENTS OVER NORE THAN 3NE LINE 

SES can fiandte continuation lines Ceven when you're using SES 
inter active ly)# for those cases where you can't specify aH you i#ant 
to on one line* You indicate continuation by olaclng ti«o or more 
periods at the end of the line. SES then asks for continuation 
lines to be typed in. For exaiitple s 

/ses«print f*Csnarkf shark# charnedy quarkst •• 
• •? larksf booJyiiis# grogs^ bander# snatehi) 

After you've signalled the incoiapiete line by placino an ellipsis at 
the end of the I ine# SES prompts for a continuation line with a «•? 
at the start of each continuation line. The slash I/) before the 
ses on the first line indicates where MOS outputs its. prompt for 
commands. 



When you use SES In a batch Job streai! you simply code the 
continuation lines one after the other* each Incomplete line having 
the ellipsis at the end> for example : 

batch 
Job 

stateiRents 
SES.CQLLECT ICHENAS* FLEURIE* MORGON* CORNAS, TAVEL^ .• 
GHEHNE# SOAVE* ORVIETOf CARENAf PARRmAy 3AR0L0) 
and more 

batch 
Job 

statements 
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1.1.6 PROFILE - SETTING UP YOUR LOCAL ENVIR3NH6NT 



A PROFILE is a file where you can place Information about you and 
the things you^re currently working on* Hany SES procedures use 
infoniration out of the PROFILE to set up defaults for frequently 
used things^ such as the name of an object library* Having a 
PROFILE can save you much time since you don^t have to code 
parafneters for Information that's already In the profile* 

If you want to have a profile* you should create a file called 
PROFILE which has the word PROFILE as the first fine of the file* 
The most important and useful pieces of Inforfnatlon to place in your 
profile are your fiasSMa£i> iih^tU& auMk&L a'^t! acaiSSt auili££» Thus, 
your Initial profile should have <at least) the following in its 

PROFILE 

\ passMor* *your. password* 

\ charge « •your.charge^nusiber* 

V project « *your.prbJect_naib8r* 

An £isi way to set up an Initial PROFILE for yourself Is to call 
the BuILD PROFile (fiifiESQiE) procedure like this J 

ses»bldprof 

8L0PRQF prompts you for the most common itens to be placed In your 

profile* In addition, it creates a MAILBOX for you* For 

information on the •"mall" facilities of SES, see the chapter on 
"USER TO USER COMMUNICATIONS"* 

SES supplies a procedure called lAF, ^ihlch sets up defaults for 
particular terminal types* BLOPROF prompts for your terminal type* 
and places that information in your profile* For further 
information on IAF# see the lAF procedure description In the 
**mi seel laneous useful goodies** chapter* 

BLOPROF will also ask you for your graohlcs terminal type which 
may be different than your usual terminal* Even If you use the same 
terminal for graphic CCAOSG) and non^graphic wor'k, you should answer 
both requests* BLDPROF will ask additional questions about your 
graphics terminal - baud rate, hard copy available, and for 
TEKTRONIX 4014 Extended Graphics Module and synchronous or 
asynchronous* For further Information on CAOSG, see the CADSG 
procedure description in the Structured Process Tools chapter* 

There are many other things that may go Into your profile* These 
are mainly concerned with source code maintenance and library 
management functions and so on* These other aspects of profiles are 
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discussed in the chapters dealing vijth the specific subjects* 

Another useful thing that can go Into a profile Is SES directives 
that specify which procedure libraries* and where^ to search for 
procedures. The SEARCH directive Is discussed In the appendices* 
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1.1.7 SES PROCEDURES RUN AS BATCH JOBS 

« 

Instead of running Interactively* or "vthile you wait" at your 
terminaly fflany SES procedures can be sub^nltted to run In the 
background as batch jobs. You do this by coding a Ji^i (batch or 
batchn or defer) which causes the fraitiework o^ a batch job to be 
built around the specified procedure* then SUBSIITs the file so built 
to NOS as a batch job. 

Using SES in this *iay is often very effective* especially where 
the job to be done uses lots of resources. By running the job In 
batch* you can proceed %fith your interactive session Instead of 
having to wait. 

For such procedures* the list of parameters described below are 

those which affect the running of the batch job. Note that these 

paraiseters are suli applicable if you run the procedure in batch 
mode (that is* non-local). 



jobun 



jobpw 



jobfmly 



jobcn 



(optional) JOB User Name to be used on the USER statement 
of the batch job. If you don't code the jobun parameter* 
the job is built with the user nane of the current user. 
tlnifi : that In some NOS sites* It Is qqX^ 2SS5iM5 to 
SUSHIT a job to run under another' user's account. The so 
called "secondary user" statment Is disabled. If 

secondary user statements are disabled* and you try to 
submit a job for another account* you get liiflafiii iiffi 



(optional) JOB Password to be used on the USER statement 
of the batch job. If you don't code the jobpw parameter* 
and there's no passwor variable defined In your profile 
(see the section on profiles)* SES asks you for your 
password in a s imi I ar manner to that of ^OS* 



(optional) JOB FaMICY to be used on the USER statement of 
the batch job. If you don't code the jobfnly parameter* 
and there's no family variable defined In your profile 
(see the section on profiles)* the fainlly name for the 
current user is used. 



(optional) JOB Charge Number to be used on the CHARGE 
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stateiRent of the batcti job. If you clor\»t code tlie Jobcn 
paraJReter* and there's no charge variable defined In your 
profile fsee the section on profitesH SES asks you for 
your charge number. 



Jobpn 



Jobfl 



Jobtl 



Jobpr i 



bin : 



(optional) JOB Project Number to be used on the CHARGE 
statement of the batch job. If you don't code the jobpn 
parameter* and there's no project variable defined in your 
profile (see the section on prof 11 esl» SES asks you for 
your project number. 



(optional) specifies the JOB Field Length to be used for 
running the job. You don't norirally need to code the 
jobfl parameter* since alt the procedures i^hich run in 
batch set the Ft to the required value* If you want to 
specify the job field length as an asialj number* you iMSi 
add the IS) suffix to the number* because SES treats 
numbers as decimal unless told other*<ise. 



(optional) specifies the JOB Time limit to be used for the 
job* This is alitays the same for* all procedures* namely 
2000(8)* If you need more time for the Job* you must code 
some value for the jobtl parameter* If you want to 

specify the job time limit as an asta'i ^^"^^^^^ ^^^ lU5t 
add the (81 suffix to the number* because SES treats 
numbers as decimal unless told otherwise.- 



(optional) specifies the JQB PRIorlty (that is* the P 
parameter on the NQS job statement). If you want to 
specify the job priority as an aatal ^u'Bber* you B\iSLt acid 
the (8) suffix to the number* because SES treats numbers 
as decimal unless told otherwise. 



(optional) fiili number parameter used at sites allowing bin 
references to Indicate which ••bin» the job output should go 
in. The bin parameter Is codei In the form of a string* 
for example i bin«'7h'* You can also define a userbin 
variable In your PROFILE (see the section on profiles)* so 
that the bin number is picked uo automatically. SES 
generates a large print banner of your bin number on the 
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front of the job outputs and also places the bin nuaiber in 
tbe job name field of the job statement. if you don't code 
the bin parameter* and there's no userbln variable defined 
In yoyr profllef SIES generates a bin naipber of NO-ID* which 
almost certainly guarantees that your Job output ends up In 
the HOS/MQ BIN MUI18ER bin, 

focal or batch or batchn or defer t 

coding one of these (optional) keys determines the mode In 
which the procedure or Job Is to be run. Coding the local 
liig^ runs the procedure LOCAL to your terwlnal* or »«hile 
you wait* Coding the batch IsgV Issues a SUBMIT with 
option B for the SU8HIT statemer^t* Coding the batchn jifix 
issues a SUBHIT with the N ootlon for the SUBHIT 
statement* Coding the defer Issi DEFERS the job for after 
hours running. You can find aM ?>f the details of the B 
and N parameters for SUBHIT in the NOS reference manual. 

nodayf or dayflle or df i 

this (optional) parameter aoplles to some of the 
procedures that can be run as batch Jobs. Each procedure 
description (for procedures which can run as batch jobs) 
specifically mentions this paranseter only If the procedure 
makes use of It. For those procedures that do use it* 
this parameter applies only if the procedure Is run as a 
batch job (that Is* non-local). If you don't code the 
parameter at all* or if you simofy code dayfile or df* if 
the job hits an EXIT statement due to errors* the job 
dayfile is dumped to a file called dayflle* which is 
placed in your catalog when the Job terminates. If you 
code dayf I ie»f iienane or df«fllename* the dayflle is 
placed in your catalog in a file o^ name filename. If you 
code the nodayf option* no dayfM% Is produced at job end. 
The diagram below provides a more graohlcal explanation of 
the interactions of the dayfile oarameter'. 
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QM&i Ob 



k^tlm lalisa 



Nothif^g 



Job dayfile is dumped to file dayfile if any I 
errors occur during the Job* » 



dayfile or 
df lifijt 
onl y 



Job dayfile duiaped to file dayfile if any • 
errors occur during the Job. I 



I dayf i le«f I le.naaie 
i or df«file.name 



Job dayfile dumped to fife f 11 e.fiaaie If any » 
errors occur during the Job* J 



I nod ay f h&t 



Job dayfile is nat du^sped even If errors I 
occur during the Job* * 



yfitfi • that only those procedures whose descr lot Ions contain a 
reference to the para?«eters described above can be run as batch 
Jobs* 



Exainpie of Batch Usage 



A fairly widely used SES procedure is LISTMQO (^hlch supplies a 
cross reference and a printout of the nnoduies In a base - see the 
chapter relating to source text «nai ntenance) • LISTHOD runs ••while 
you wait" by defaultt and since it grinds* it^s nuch better to run 
it batch, I Ike this 5 

ses* 1 1 stmod b^newdata* batch 

X5*00.19* SUBHIT COMPLETE. J08NAME IS AFTQ8XT 
REVERT, JOB LISTMOO SUBMITTED 

This example shows a simple usage of lISTiOD run In batch by coding 
the batch t&i* The example assumes that your passwords charge 
number, project number and all are defined In your PROFILE as 
described earlier* The message is returned by HIS s it's the time 
of day that your Job was submitted, and the so called job name* The 
last message about job submitted comes fron SES*s 
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1 . 1 * 7 • 1 £EQ£IL£«2 JXLlaMfis-f a£-£aQi;£i2lliai3«l J tijii -lad s 

SES procedures that can optionally run In batch laode «iay be 
controlled by the settings of certain trarlables In your PROFILE. 
This fBakes it easier to use SES all round* since yby don»t then have 
to supply the Inforsiatlon every time you use a procedure. The set 
of lii£.££ti^££ below can be coded into your profile If you wish. 



PROFILE 

\ passMor » 'your. password* 

\ charge « •your.char ge^nuiiber* 

V project * •your. pro ject^number* 

\ faiRi ly « «your_fa«Hy« 

passMor defines your password 

charge defines your charge nuwber. 

project defines your project nuwber. 

family defines your family name. 

USktS ' that if your validation on the systasn Is such that you do 
not require a CHARGE statement in batch jobs or when you log In at a 
terfliinal> you should set the charge and project variables to null 
Cempty) strings. This Inhibits the generation of the CHARGE 
statement by SES for batch jobs. 
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Exan^ples of PROFILES 

PROFILE 

\ passHor « «ASTERIX« 
\ charge » 'OBELIX* 
\ project « «GETAFfX« 

That is an example of a ainimal PROFILE, here's a typlcaf PROFILE 
as It fljight be defined for a user 5 



PROFILE 

\ passwor « •MA8BIT» 

\ charge » «« 

\ project « •» 

\ ffiyname « •Lorenzo Oesmondo 0»»Hare« 

Note that the charge and project yarlabfes are set to empty strings 
- this would apply to sites that don't require CHARGE statements on 
MOS. 
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1.1.8 INFORMATIVE MESSAGES FROH SES PROCEDURES 

Hany SES procedures are set up such that when they run ••ithlle you 
wait'* at the terinlnaU they output Infori^atlve isiessages to tell you 
nhat they're doing. The informative messages are controlled by asij 
and Qfiisn luaxs. on the appropriate procedures. The normal default* 
In the absence of any other information is for the procedures to 
output informative messages. CotJIng the nomsglisx suppresses the 
messages. However* It Is possible to establish your own default by 
defining a profile variable called msgctrl; The msgctrl variable 
can be defined In one of two ways 5 

\ msgctrl « •♦• this sets the nor?«af default for informative 

messages to no messages. In order to obtain 

messages from procedures the nsg js^jt must be 
coded on the procedure call* 

\ msgctrl « •SESHS6.*« this sets the norual default to output 

Informative messages. To turn messages off* 
the nomsg |££^ must be coded on the procedure 
call. 



The table below should give a more graohlcal idea of the 
interactions of the msgctrl variable and the msg and nonsg t&xs. o" 
the procedures. 



J 2££IM£fi m ESaiIL£ J 

+ . -+^ ^ . ^ ^^ .. — 4. , — . 4. 

S Cadfiil Oq S! Nothing S \ MSGCTRt=«SESMSG.*« ? \ HSGCTRL««*« 1 

5 £Lflfi£llJ4LS SI 5 ? I 

•f — i— • ' + 4.——-.. 4.— « — « — -^, — «^-— ^-,-, , — 4. . -«. «. 4. 

« Nothing ** Messages * Messages * No Messages ' 

« MSG ;; Messages * Messages * Messages * 

4..«-. — ^„— ^-^+ — -. 4. , . ^4. . 4. 

S NOMSG SJ No ; No Messages 5 No Messages ! 
* •* Messages * ; * 
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1/1.9 GENERAL NOTES ON SES PROCEDURES 

SES procedures are# In generalt wfltten to do the detail «ork for 
you> so you can concentrate on the job at fiand. Let's look at the 
workings of a typical SES procedure - kill |S:iI Coded Eecord 
CCOPYACR)* to see what It does 5 

ses«copyaer l»lnput.f I ie# o«output«f 1 1 e 

REVERT. END COPYACR IMPUT.FILE -> OUTPOT.FILE 

The COPYACR procedure ewlts NOS control statements to do the 
foliouing s 

§sgyiCS the Input^flle <see the note o^ ACQUIRE below) 

^S,B.UILS, the program (tool) that does the CGI^YACR process 

CfttyCQ the output^fMe 

£0£I4CE ^rofli Input. file to output.file 

££iM£a the COPYACR program 

££MilllJ both the input. file and the output^flle 

you may if you wish* use procedures such as COPYACR like this s 

ses.copyacr f i le^to.be.processed 

REVERT. END COPYACR FILE.TO.BE.PROCESSED 

In such cases* where does the output of the procedure go? Well it 
certainly doesn't go to file output (the terminal). In such cases* 
the output file eventually replaces the input file t 

J£Jlui££ the f i I e.to.be.processed 
M&^uLlS, the COPYACR program (tool) 

£fl£IMB f 11 e.to.be.pr ocessed to a unique.naitied_teflip.fHe 
L&tiltU the COPYACR program 
* tSDaiS f 1 1 e.to.be.pr ocessed * unl que.>iaiiied.te»iip.f 1 1 e 
15tll£Q unlque.naffled.t eiBp.f I le 

There are many SES procedures that function this way - they are 
often referred to %s FILTERS - a process that copies an input to an 
output with some transformation In between. 
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When you call up an SES procedure to s 

ses.do.some^process l«lnput«f lle> o«oiitpiit_f I le 

one of the control statements emitted by the Procedure Is a 
statement to ACQUIRE the Input. filet which naans ; 

!• If there's a LQLAL ^He of the required na'«e> EiMlMfi that file 
and use It as the Input. fife. 

2« otherwise AII1£M or S£I a permanent file of the required name 
froffl the current user's catalog. 

All this means you don't have to car% whether' or not files are 
local - SES procedures grab whatever Is available under that nawe 
that is what ACQUIRE is all about. There Is a full description of 
the ACQUIRE utility in the Appendix. 

The foregoing has some Interesting effects which you should be 
aware of however. Consider the following sequence s 

ses.flles; catlist 

VORK... ...IZ PT. 

CATLIST OF WCN C 9 FILES* 2685 PRUS I 
HAILBOX I SP A ...l OLOUSER PU R 112? PMTSORS PU R .105 
PROCLIB D SP R .124 PROFILE I PR R .^.1 PROSLIB PU R .835 
SEVEN.. I PU R ...2 STATSES PU W .1^85 USERDIR I PU R ...5 
REVERT. END CATLIST 

ses.pack i«statses 

REVERT. END PACK STATSES 

ses.fi I es 
WORK... ...12 PT. STATSES ..481 L3. 

REVERT. END FILES 

Note that we PACKed file STATSES. Note that orl gi nal ly> STATSES 
was a PERNANENT DIRECT ACCESS file. By the tim^ the PACK process 
finished however* the PACK procedure (because of the RENAME process 
described earlier I has now left a LOCAL file of the seme name. SES 
procedures don't* in general* rewrite permaner^t files. Those that 
do say so explicitly. 
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If yoy followed the description of the beNavrlor of SES procedures 
above^ you may take note that SES Is desi gnsd pr I war i ly as an 
iMI£E4£IIiE tool* You £tll use SES In batch Job streams If you wlshf 
Mi you should be aware that SES procedures don*t» in generals make 
a special case of files iMEllI an<i QillEill* i^hereas MOS lass make a 
special case of files IMEMI and QUIEIir* Usually* when using SES 
procedures interact ivel y> you don't use QUIEUI ais the output file 
from procedures* those procedures that 3^' ^ss IMEUI or QUIElil say 
so* and take special note of those files* AM this means that If 
you run SES In batch streams* and use files IMEill or QMIEill as Input 
or output to procedures* you're likely to lose a lot of output 
because SES procedures E£MI!ifi or I£iyEti thin?|s* So* to avoid grief* 
uses f I les other than IMEUI and QyiEUI* 



tdhen SES builds the JCL stream from an SES procedure* programs* 
scratch files and so on are usually given unique names* so that you 
don*t have to care which names are reserved by each particular 
procedure* These SES generated unique riames are always seven 
characters long* always begin with the letters ZQ* and are always 
guaranteed to be different from the r^a^e of any file currently 
assigned to the running job* This note Is for' your information* 
just In case you ever look at a dayfile where SES procedures have 
been used* and see lots of funny looking names* The example below 
shows the JCL generated by the ses«iiiiiits procedure* 

$RFtC 20000} 

$IFE< FILE C OUTPUT* AS l*tABEil) 

$RENAMEaQWT8Q6«0UTPUT) 

$EN0IF(LABEL1) 

$ASSIGNIHS*OUTPUT) 

SLIHITS* 

$RENAME{ZQWT8QQ«aUTPUTI 

$IFE(FIL£<ZQWT8Q6*AS)LABEL2) 

$RENAMEI0U1^PUT»ZQWT8Q6) 

$EN0IF(LABEL2} 

$REWIND(ZQWT8RA) 

EDT(ZQWT8QQ*ZQWT8RA*ZQWTdRW) 

$RETURN<ZQWT8RA*ZQWT8RW) 

$CGPYBRCZQMT8QQ#0UTPUT) 

$RETURN<ZQtfT8QQ} 
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SRFLCOI 

REVERT, END IIMITS 
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1.1.10 PROCEDURE DESCRIPTION CONVENTIONS 

The remaining chapters of this handbook describe SES procedures 
that are currently available. Each procedure description contains a 
list of parameter descriptions! and the order in which the 
parameters are described specifies thel r oosl tl onal significance 
Hithin the procedure. 

Only those procedures that wake refere?ice# In their parameter 
lists* to the "batch job par aweters" Csee the section calfed "SES 
PRQCEOURES RUN AS BATCH JOBS") can in fact be riMn as batch jobs. 

If a procedure description does not contain a description for a 
parameter* that procedure does not have such a paraineter. 

If a parameter description does not axplicitfy specify that a 
parameter Is optional then the parameter must be supplied when the 
procedure is called. 

In order to reduce redundancy within procedure descriptions* some 
of the features provided by a procedure are discussed In the 
descriptions of particular parameters* therefore* we strongly 
recommend that when you read a procedure description* you read the 
whole thing. 

Before you read a particular procedure description* we strongly 
recommend that you read the introductory subsection of the chapter 
containing the procedure description. Such things as general 
parameter descriptions* profile usage* and naming conventions are 
discussed in those subsections. 
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1.1.11 PARAMETERS TO THE SES PROCESSOR 

You have just read about parameters for* SES procedures In the 
first sections of this chapter. You can f!so oroflde parameters to 
the SES processor to direct it*s actions. These parameters come 
after the SES* and before the .procedure.nane. These parameters may 
be specified in order dependent or keyword manner. 



1.1.11.1 UM 

The UN parameter specifies the catalog containing the requested 

procedure. For example* if a procedure is In the SESPLI3 library on 

catalog TEAM* just type SES»UN«TEAIi«procedur e.name to use it. See 
also Appendix A. 



1.1.11.2 L££l!l 

The tPFN parameter specifies the library permanent file name of 
the SESPLI8 containing the requested procedure. If the library is 
on another catalog* both the UN and the IPFM parameters are needed. 
For example* 

S ES *UN=TE AH* LPFN'PROJ LIS. prose dure. name 

gets the procedure from library PROJLIB on catalog TEAM. See 
Appendix A for more information about accessing procedures. 



1.1.11.3 £Uti 

The PUN parameter specifies the catalog containing the PROFILE 
you wish to use. See Appendix A for addltltinal details. 



1.1.11.4 £ 

The P parameter gives the name of the PRIFILE ^i 1 e you wish to 
use. See also Appendix A. 
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1.1.11*5 nm 

The OUH paraiBeter Is a default catalog that cor^tains the user 
flies needed by the procedure being called. For example* 

S£S»DUN»TEAM. PRINT TFSTFIl 

will print file TESTFIL from catalog TEAH.I This parameter Is 
generally used with the OPN parameter. 



1.1.11.6 a£i 

The DPN parameter Is a default packname that contains the user 
files needed by the procedure being called. This parameter allows 
you to maintain your files on a private pack and still use them with 
SES. 



1 « 1 « 1 1 • 7 ££fi£SSSa£.0&££at iB^.tlfli£.£a£Jl£tSC 

The next parameter determines the operating Pode of the SES 
processor . 

The SES processor processes procedures In one of four modes 5 

RUN This is the normal mode. The orocedure Is processed* 

presumably generating control statensnts* and then these 
control statements are executed. 

TEST In this mode the procedure is processed In the normal 

manner* tiUt. the generated control statements are not 
executed* instead they are placed on a designated file for 
possible Inspection by the user. This mode is meant as an 
aid In debugging new procedures. 

HELP This mode is similar to test snade* however Instead of 

generating control statements* a procedure set up for HELP 
mode produces some documentation on it*s purpose and usage. 

STATUS This mode Is similar to test mode* however Instead of 
generating control statements* a orocedure set up for 
STATUS mode produces any change I nf or ii'^t Ion available about 
the procedure. 
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Refer to Appendix 8 for additional Information on these modes* 

l.l*ll*?.l lUM 

Tfiis is the normal operating «ode of the processor and Is the 
default fnode» The specified procedure Is processed and executed. 
It is normally not necessary to specify ruT« as the nnode. 

1,1,11*7.2 I£il 

The TEST parameter tel Is the SES processor to execute in TEST 
sdode* In this mo6ef the procedure is processed in the normal 
manner* but the generated control state'^ents ar'e not executed* 
Instead* they are placed on a deslgf^ated file for possible 
inspection by the user* 

S£S»TEST«myf i I e* procedur e_naie 

will place the generated control statements on file myfile* If no 
file is specified* SESTEST *iill contain the control statements* 
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l.l,11.7.3 iJIL£«aE.iJ 

The HELP par aroeter tel Is the SES processor to execute in HELP 
mode* SES provides a wode of operatiofj of procedures that produces 
descriptive inforination about the specified procedure. The 

information Includes a one or two sentence description of what the 
procedure does plus a list of the parameters* their defaults* and 
the permlssable values* In addition* required parameters are 
••flagged** with CRI and defaults that btb controllable by PROFILE 
variables are ••flagged** with an ♦. To get the help documentation 
for a procedure listed out on your terfiiina!> you slisply type : 

sesf Nel p*procedure.naiie 

Notice that no pararaeters are given* SES responds by displaying the 
help docufiientati on for the named procedure (If any Is available)* 
For example t 

sesf help* getiiiod 
produces s 



6ETNO0 extracts 1 or fpore modules Idecksl 
library and places them* in MAOIFY source 
Parameters ares 
— PARAHETER— ^ DEFAULT- 



frow a MAOIFY base 
format* on a group fife* 



CR) m»all 

g* group 

byi 

un 

cors*c 

width*M 

status* sts 

fflsg»nomsg 
•HELP FOR GETHOO 



none 
*group 
*base 
♦current user 

none 

madify 

none 
♦msg 
ON FILE OUTPUT- 



ALLOWABLE VALIIEIS) 

MADIFY decknamefsl 

f i lename 

f I lename 

username 

f I lename 

numeric lax I mum width 

Keyword 

keyword 



(ranges allowed) 



of retrieved deck 



on 



SES*HELP*myf 1 1 e*pr ocedure.name will 
file royf i le. 



place the help documentation 



a tutorial 
is for 
exper i enced 



that help mode is not intended as n training mechanism or 
for new SES users - that's what this SES User's Handbook 



help mode 
SES users* 



is there as 



nemory Jogger** for more 
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1.1.11.7.4 lIiiy<i.fl£«S 

SES provides a STATUS wode of operation that lists current status 
information about the specified procedure. Changes to SES 
procedures that potentially affect users are coiamanicated in this 
manner. To get status information on a particular procedursf you 
simply type s 

ses> status.procedure.liaie 

Status items are listed in reverse chronological or'der. All changes 
affecting the procedure since the previous SfS Release are listed. 
For example s 

ses» status vgencomp 
could produce s 

02/09/82 

The field length value used by GENCQMP has been Increased to 
77700<8) to accommodate larger program libraries. 
STATUS OF GENCQMP ON FILE OUTPUT 

SES# STATUS«myf i le. procedure.name will Place the status 
information on file myfile. 
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1*1.12 PRE-RELEASE VERSIONS OF TOOLS 

SES provides a convenient and conslster^t iiethod for accessing 
pre-release versions of SES supplied toots. To access the 
pre-release version of a procedure* you sinofy type ? 

sesf sss.procedur e.naine I Ist^of ^parameters 

If there Is a pre-release available for the specified tool* it 
executes. If there Is no pre-release version* you get the standard 
release version. 

If you always want pre-release versions of tools that are 
available* you can place in your PROFILE the follOiilng directive s 

\ SEARCH* USER* SSS* SESUNAH 

This tells SES to first look in the current user's catalog for the 
specified procedure CJust as normally happens)* then look in the 
pre-release catalog (SSS)* and finally look In the standard release 
catalog (specified by the SESUNAM variable). 

A more detailed description of the SEARCH directi ve can be found 
in the Appendix. 
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1.1.13 PRQBLEii REPORTING 

Problems encountered while using a released SES tool should be 
reported using a PSR iPrograiBining System Report* CDC foria AA1901). 

Problems encountered while using a pre-Tsleased SES tool should 
also be reported using a PSR C Pr o gr amfning Systsu Report* CDC foria 
AA1901). 

The completed form along with all support (naterlals should be 
sent to the Arden Hills PSR Coordinator {A!?^^3{)!« 
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1.1.14 APPLICABLE DOCUHENTS 

SES provides a procedure catted TOOLOOC which pro^idies ••on-line'* 
access to many SES docutwents. If you caff TOQLDOC MiiMill M^illi3 
m^ filCMStSCS.* you get a list of the avaMable DCS docuaients. 

The foHoviing CDC manuals for NOS/170 siav be of help to users of 
SES. 

60455280 CY8IL Reference Manual 

60457280 CY8IL Language Specification 

60457290 CY8IL Handbook 

60457260 NQS DEFINE Data Dictionary Tools User's Handbook 

60457270 NOS GRAPH Graphics User's Handbook 

60435400 NOS Version 1 Reference Hanuat {Volume 1) 

60445300 NOS Version 1 Reference Manual fVoluie 21 

60455250 Network Products Interactive Facility Version 1 

Reference Manual 

60435500 NOS Version 1 Time-Sharing User's Reference Manual 

60450100 NOS Version 1 Modify Reference Manual 

60492600 COMPASS Version 3 Reference Manual 

60328800 SYMPL Reference Manual 

60497800 FORTRAN Extended Version 4 Reference Manual 

60481300 FORTRAN Version 5 Reference Manual 

60429800 CY8ER Loader Version 1 Reference Manual 

60481400 CY8ER Interactive Debug Version 1 Reference Manual 
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2 • i£i«££a££aUE£.LiiE4EX«MiM£MI!iI 



SES supplies a separate set of procedures to nuanage SES procedure 
libraries* These libraries are in a unique format that is 

Incompatible with other library inanagement procedures provided by 
S£S5 e»g«# REPMEM. SES Procedure libraries are always maintained In 
sorted order. The terminology that these library management 
procedures use are as fol lows : 

LIBRARY A collection of SES procedure records on a file* AM 

SES procedure library wanageient procedures use an I 
parameter to refer to a Library* 

PROCEDURE A single record In an SES procedure library file* or a 

file containing a procedure s^hlch Is added to or 
replaced on a library* AM SES procedure library 
management procedures use a p parameter to refer to 
PROCEDURES. 



GROUP a collection of procedureCs) that occupy one record 

per procedure on the file* 
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GETPROC GET PROCedures aui af a library lata ^ group file* The 

procedures appear one per logical racor«1» 

REPPRQC REPIace or add PROCedures on a library* You also use 

REPPROC in a special way to create a brand new library 
from scratch* 



CATPLIB CATalog a Procedure LIBrary to disoTay tfie names and the 

types of procedures in the library* In short forw output* 

LISTPROC LIST PROCedures* LISTPROC generates a catalog of all the 
procedures on a library* and optionally prints every TEXT 
procedure from the library* 



WIPEPROC WIPE (delete) PROCedures from a llbrtry* 
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This section jfitroduces the paraiiieter naming convention that's 
common to inost of the procedures in the prbcedtife If brary management 
system* 

I or b name of Library on which the ooeratlons are to be 

per formed* 

P stands for Procedur e( si • 

g or group name of file upon which a GROUP of procedures 9r e 

accumulated when adding or replacing procedures on a 
llbraryf or when procedures are eittracted from a 
library* A group file contains one procedure per 
logical record. 

nl or nb name of a New Library or Ne« 8ase# used In those 

procedures that perform operatlofis that permanently 
alter a libraryt requiring that a new library be 
created* An explanation of the method used to update 
a library Is contained In a subsequent section. 
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The variables described below way be declared in your PROFILE in 
order to establish default Inforffiatlon for the parameters of the 
procedure library manageflsent procedures* 

pllb name of procedure library where procedures are to be found 
or replaced* 

pllbowfi user naiae in whose catalog the procedure library is to be 
found* 



newpllb name of new procedure library for those procedures which 
update a library* thereby creating a new one* The default 
name for newplib is the same name as the old library* 

group used by all procedures to designate a group file* or a file 
containing one procedure per logical record. The default 
name for group is group* 

sestnpp used by ail of the procedures that update procedure 
libraries to specify the temporary library file during the 
update process* The default name for this file Is sestmpp* 

lokmode determines the interlocking action when updating a 
procedure library* The lokmode y^riahle may be set to 
•LOCK' (lock by default unless the nolock parameter is 
coded on the procedure) or «NOLOC<* (no lock by default 
unless the lock parameter is coded on the procedure)* 

intrlok used by all of the procedures that update procedure 
libraries to specify the i nter lock f I f e to be used during 
the update process* The default name for the Interlock 
file is intr lok* 
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Soffle of the procedure library management procedures ptiyslcaHy 
alter a library* requiring that a new library fee created* The 
process Is coiniaon to alt such procedures* arid Is as follows s 

If you code both the I and nl parameters* the new procedure 
library is created simply by performing the required operations on 
the old library^ and writing the newly created library onto the file 
specified fey the nl parameter* 

If you code only the I parameter^ the update tal<es place In two 
stages* The updating operation is performed and the new library 
written to a file called sestmpp CSES TeHPorary Procedure)* sestapp 
is then physically copied back over the fife specified by the I 
parameter* and finally sestflipp is purged. 

Note that if the file specified by the nl Cor I if nb is omitted) 

does not already exist* a DIRECT access READ mode file is OEFINEd 

for the library (this* of course* can only be done If the owner of 
the library is the current user)* 

Note that if anything goes wrong during an updating run* the 
original library is always left intact* and only the new library or 
sestmpp Is potentially Incorrect* This means that you can recover 
by purging the new library or sestmpp and starting the run again* 
If something goes wrong ijaffitfi the library nppBzrs on sestmpp* 
original library is intact* and sestmpp nay be ourged* whereas If 
something goes wrong jtJLfit the new library Is on sestmpp* that is* 
during the '•rewrite" phase of the update* It is sestmpp that Is 
safe* and the old library that is wrong* In this case* you may use 
the REWRITE procedure to do the rewrite again* nr alternatively* you 
may just purge the old library and then change the name of sestmpp 
to be the library name* 



2-6 
COC - SQFTI^ARE ENGINEERinG SERVICES 

18 DeceiBber 84 
SES User«s Handbook REV: 4A 

2,0 SES PROCEDURE LIBRARY MAMAGEHENT 



When updating a library you can interlosk the update so that only 
one user at a time can update the library* Those procedures that 
update a library are set up so that if the library to be updated is 
in another user's catalog^ the library is Interlocked by default* 
You can override default actions by defini^^g a loknode variable In 
your profile^ or by coding a lock or nolock i^X on the procedure* as 
shown In the diagram on the next page* 

Interlocking of a library is done via an interlock file* Such a 
file lUSt be a QIE£QI access file la ths iaig liSSLll satliilfl as lh& 
LLUlalx U&LQU iikSiMtSi* Naturally the Interlock file must be a 
PUBLIC* WRITE HQOE file If other users are likely to be using It, 
The default name used by the SES source code nual nten ance and library 
manageipent procedures for the lock file is Intrlok. You can have an 
interlock file of any name by defining the I ntr I ok prof I I e variable* 
or by coding a file name as a value for the lock? parameter on the 
appropriate procedures. 
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regardless of contents 
other condi t tons. 
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^QtlSL^ ljli£0 
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unless overridden by nolock 
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\ lok«ode««NOiQCK« 



1 Ibrary o 
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GETPROC is Intended for extracting any r^tiiber* of procedures from 
a SES procedure library onto a group filet ^Ith one procedure per 
logical record. Parameters to GETPROC are s 

p or proc or all ? 

If you code the all keyword* GETPROC extracts ALL 
procedures from tt^e procedure I I br arV specif I ed by tl^e I 
parameter. Otherwise^ you code the p parameter as a list 
of name{s) of Procedur e(s ) to be extracted. Ranges of 
procedure names may also be coded* as shown in the 
examples at the end of this description. 



g or group : 

(optional) name of group file tn receive the procedureCs) 
extracted from the procedure library. If you don't code 
the g parameter* GETPROC uses the value of profile 
variable group* and If there's no such variable defined* 
uses the name group for the group file. 



I or b 



un 



(optional) name of procedure Library from which the 
procedure(s) are to extracted. If you don't code the I 
parameter* GETPROC either uses the value of profile 
variable pi lb* or if that's undefined* GETPROC uses the 
name pi lb for the name of the pracedur'e library. 



(optional) User Name in whose catalog the procedure 
library specified by I Is to be found* If It isn't In the 
catalog of the current user. If you don't code the un 
parameter* GETPROC uses the value of profile variable 
pllbown* and If there's no such variable defined* the 
GETPROC uses the user name of the current user. 



status or sts $ 

status is an (optional) JijBi used for those cases where 
GETPROC is being used as a building block of more 
sophisticated procedures or jobs. The status parameter 
causes GETPROC procedure to set the job control register 
EFG to the value zero if GETPROC successfully completed* 
and non zero If anything went ytrong during the run of 
GETPROC. If status is not quoted ^n6 an abnormal 
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2U SETPROC - EXTRACT PROCEOURECS) FROH PROCEDURE II8RARY 

condition occur Sf GETPROC wMI ^itTV 



Exaiipies of GETPROC Ustge 

ses*getproc format f«sespiib un«lr77 
REVERT, END GETPROC GROUP <- SESPLI8 

The exaf^ple uses GETPROC to get one procedure ctl I ed foriRat frorp 
a library called sespfib in the catalog of user Ir77» 

ses«getproc I txtcode»txtfor«ftxtheadl binary l«prgHb un*iiv73 
REVERT. END GETPROC BINARY <- PR6L1B 

This example extracts a group of procedures froi an SES procedure 
library called prglib in the catalog of user* iiiv73 and places them on 
a group file called binary* 

ses.getproc { cat! 1st* «changef compare.^^lfayweekl fssasplib 
REVERT* END GETPROC GROUP <- SESPLI9 

This example illustrates how ranges may be coded for a parameter. 
The example extracts all procedures catllst through change 
inclusive^ and all procedures compare through dayHeek Indus! ve» 
from an SES procedure library called sesp1fb» and places the 
extracted procedures on the file called group* 
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2,2 REPPROC - ADO OR REPLACE PROCiOURECSI CIM PROC.t LIB. 

REPPROC is a procedure to add new procsduretsl to* or replace 
procedureCsl on an SES procedure Hbrary* Parameters to REPPRQC 
ares 



p or proc s 

(optional) list of fHeCs) containing Procedure(s) to be 
added to or replaced on the Procedure library* If you 
don't code the p parameter, REPP^OC assunes that all the 
procedureCs) to be added or replaced are already on a file 
specified by the g parameter* 



9 or group i 

(optional) name of a group fife on which procedureCs) are 
accumulated as one procedure per' loiilcal record. If you 
don't code the g parameterf REPPROC uses the value of 
profile variable group. If there's no such proflJe 
variable defined^ REPPRQC uses filena?ne group as the group 
file. 



I or b J 

(optional) name of procedure LIbrarV on which the 

procedure(s) are to be added or repliaced. If you don't 

code the I parameter, REPPRQC uses the value of profile 

variable plib as the name of the procedure library. If 

there's no such profile variable defined, REPPRQC uses a 

library name of plib. 

ni or nb i 

(optional) name of New procedure Library to be created 

when REPPRQC has completed its run. If you don't code the 

nl parameter, REPPRQC uses the value of profile variable 

newpl lb, and if there's no such profile variable defined, 
REPPRQC writes the new procedure library over the file 
specified by the i parameter. 



un i 



(optional) User Name in whose catalog the procedure 
library specified by l/nl is to be found, if l/nl is not 
in the catalog of the current user. If you don't code the 
un parameter, REPPRQC uses the value of profile variable 
plibown as the user name from whose catalog the procedure 
library Is to be obtained, and If there's no such variable 
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2.2 REPPROC - ADD OR REPLACE PROCEDURECS) OM PROC. LIB. 

defined* REPPROC uses the cyrrent user's catalog. 

lock or nolock : 

these (optional) parameters determine whether the base 
update process Is interlocked against s I mal taneous updatesl 
coding a filename for the lock parameter deterwlnes the 
nawe of the Interlock file. Interlocking Is the ii^lauit 
action *ihen the base being updated Is in another user's 
catalog. If you don't code either of the lock or nofock 
Iss:x5» Interlocking is controlled by the lokmode profile 
variable. Refer to the Introdiictor V sections of this 
chapter for information on the Interactions of the lokmode 
profile variable and the lock and nofock parameters. If 
you don't code a filename for the lock paraflieter* the 
contents of profile variable intrlok Is used as the 
interlock filename; If there's no such profile variable* 
the nafne Intrlok is used as the lock filename. The 
interlock file ia§.Jt be in the sane catalog as the base 
being updated. If the i nter lock file cannot be found* the 
procedure aborts. 

batch Job parameters s 

These parameters are described In the section entitled 
*«SES PROCEDURES RUN AS BATCH J1IBS". The default for this 
procedure is to run in local modet but It can be run in 
batch mode. The dayflle parameter is not used by this 
procedure. 



msg or nomsg '» 

these (optional) JifilS control the generation of 
informative messages by this procedure and are fully 
described in the section entitled "INFORMATIVE MESSAGES 
FROM SES PROCEDURES". 
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2.2 REPPROC - ADO OR REPLACE PRQCEOURE«SI 0^ PROC. LIB. 



Exaffiptes of REPPROC Usage 

ses«repproc Cfirstf secondf third) l«berT<lfb 

* FIRST •> GROUP 

* SECOND -> GROUP 

* THIRD -> GROUP 

* REPLACIMG/ADOING HEHBERS ON BERKLT8 

* LIBRARY NOW ON SESTNPP 

* NEW LIBRARY NOW ON BERKLI8 

* SESTNPP PURGED 

REVERT. END REPPROC GROUP -> BERKLIB 

This example Illustrates REPPROC used to collect three procedures 
onto a group flle^ and then place the contents of the group file on 
an SES procedure library called berkllb. The example shoHS sojne of 
the inforiaative messages that ^ppe^T during a REPPROC run. 



ses.repproc nl«sesplib# g«neiiproc 

* CREATING NEW LIBRARY PROCLIB 

REVERT. END REPPROC NEWPROC -> PROCLIB 

This example Illustrates how to build a ne** SES procedure 
library. The new procedures to be added are on a group file called 
newprbc. 
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2,3 CATPLI8 - PRODUCE LIST Of PROCEDURES t1 A PROC* LIS. 

CATPLI8 is ysed to display a procedure tist of the procedures \n 
an SES procedure library. CATPLIB outputs the procedure list In a 
condensed formatj five procedures per lint* showing only the 
procedure nafses. Parameters to CATPLIB are J 



I or b 



un 



(optional) nasae of procedure Library which Is to have Its 
procedure names displayed. If you don't code the I 
parameterf CATPLIB uses the value of profile variable plib 
as the name of the library* ar^d If there's no such 
variable defined* CATPLIB uses a file nai»e of pUb. 



(optionail User Name in whose catalog the procedure 
library specified by the I parameter Is to be found. If 
you don't code the un parameter* CATPLIB uses the value of 
profile variable pllbotin as the user name* and if there's 
no such variable defined* CATPLIB uses the current user's 



catal og. 



(optional) name of file to receive the Output from 
CATPLIB. If you don't code the o parameter* CATPLIB 
places the procedure list on fUe output. 
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2.0 SES PROCEDURE LIBRARY MANAGEMENT 

2«3 CATPLIB - PRODUCE LIST OF PROCEDURES IN A PROC. LIB. 



Exantpte of CATPLIB Usage 



ses«catpi ib 
PROCEDURES 
AHYHAILHLP 
CHANSEHLP 
OAYWEEKHLP 
DUMP999HLP 
GENCPFHLP 
GETMAILHLP 
LIBEOITHLP 
NEWPSRSHLP 
REPHODHLP 
SESPARMHLP 
THPFILSHLP 
USEIMFOHLP 
XGENNARHLP 
REVERT. 



b«sestil lb ufi» 
ON SESHLIB PR 
ASORTHLP 
CHANSPFHLP 
DOCREATHLP 
DUHPPFHLP 
GENHARHLP 
GETHEMHLP 
LIfllTSHLP 
NOWLISTHLP 
REPPROCHLP 
SESPRQCHLP 
T0900HLP 
USEHSGHLP 
XGENHSGHLP 
END CATPLIB 



«v69 

OCEDURE LIBRARY 
BANHERHLP 
COLLECTHLP 
DDOISHLP 
EDTHLP 
GENHODSHLP 
GETMODSHLP 
LINKITOHLP 
PACKHLP 
REPULIBHLP 
SIMOEFHLP 
T0999HLP 
VEGEEHLP 
XLITHLP 
HELPLIB -> QUTPar 



8EL1HLP 

CQ«PHLP 

ODHLP 

FSFORHHiP 

SEHHSSHLP 

SETPFHLP 

LISTMEWHLP 

PERHITHLP 

RETAI^HLP 

SIMF^IIINHLP 

T00LD3CHLP 

VOLUMEHLP 

XREFMOOHLP 



BOVLAYHLP 

COMPAREHLP 

OOMERGEHLP 

FILESHLP 

GENPOTHLP 

GETPROCHLP 

LISTHODHLP 

PERNPFHLP 

REWRITEHLP 

SPECTRHLP 

TWOPAGEHLP 

WHOMAILHLP 

PLIB OIR 



This example shows CATPLIB output for 
catalog of user riv69« 



a Mbrary seshlfb In the 
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2*0 SES PROCEDURE LIBRARY MANAGEHEHT 

2,4 IISTPROC - LIST CONTENTS OF PROCEDURE LIBRARY 

LISTPROC performs tiio main functions to <;hoi* you *fhat»s in an SES 
procedure library* and to get a printout of any number of procedures 
from the procedure library* LISTPROC first generates a list of the 
names of all the procedures specified* Lastly* LISTPROC generates a 
printout of all procedures specified* Paraietars to LISTPROC are J 



p or pr oc s 

(optional) list of nameCs) of ProcsdureCsl to be 
extracted* If you don't code t)ils par'afneterf LISTPROC 
extracts all procedures fro^ the procedure library 
specified by the I parameter* Ranges of procedure names 
may also be coded* 



I or b 5 

(optional) name of procedure Library to be processed* If 
you don't code the b parameter* LISTPROC uses the value of 
profile variable pi lb as the procedure library name* and 
if there's no such variable defined* the LISTPROC uses the 
def au 1 1 name pi lb* 



o or output i 

(optional) name of file to receive the Output from 
LISTPROC* If you don't code the o parameter* LISTPROC 
places the output on some unique file name that it 
generates* The output doesn't default to file output 
because* if you're running LISTPROC Interactively* you 
probably don't want the rather voluminous output on the 
screen* 



un I 



(optional) User Name in whose catalog the procedure 
library specified by I is to be found. If you don't code 
the un parameter* LISTPROC uses the value of the profile 
variable plibown* and if there Isn't such variable 
defined* LISTPROC uses the user riame of the current user* 



batch Job parameters i 

These parameters are described In the section entitled 
"SES PROCEDURES RUN AS BATCH JOBS"* The default for this 
procedure is to run in batch mode* hut It can be run in 
local mode* The dayflle parameter Is not used by this 
procedure* 
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2*0 SES PROCEDURE LIBRARY HAHAGEHENT 

2.4 LISTPROC - LIST COf^TENTS OF PROCEDURE LIBRARY 



print 



this loptionan parameter indicates fio*f the output of 
LISTPROC is to be printed* Ftif the print parameter you 
fflay code any of the paraiaeters to procedure PRINT* If you 
don't code the print pararseter at all* LISTPROC prints one 
<1) copy of the output on the ASCII printer* 



iiisg or nomsg : 

these Coptional) iifi^s. control the generation of 

informative messages by this orocedure and are fully 

described in the section entitled '•INFORMATIVE HESSAGES 



FROM SES PROCEDURES". 



Examples of LISTPROC linage 

ses«llstproc print«c«3 

12.34. 56. SUBHIT COHPLETE. JOBNAME IS ACULARS 
REVERT. JOB LISTPROC SUBHITTED 

This example shows LISTPROC used to pracess a flbraryt Mhatever 

name Is the value of pi lb. Three copies of all the procedures are 

being produced. LISTPROC Is being ruf* in batch* rather than 
interact i vely. 

ses.llstproc b«sespilb o>procs pr ifit«(c»2»h»*ratest/sespl lb* I 

18.12.00. SUBMIT COHPLETE. JOBNANE IS ANAPABS 
REVERT. JOB LISTPROC SUBHITTED 

This example shows LISTPROC being run In batch to produce two 

full printouts of the contents and alf^ the procedures in the 

procedure library sespllb. The title on the listing is 
* I at est sespl ib' . 
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2.0 SES PROCEDURE LIBRARY MANAGEHENT 

2,5 WIPERROC - DELETE PROCEDURECSI FROH PR0CEI5JRE LIBRARY 

2 * 5 iI£i£aaQ---fi£i£I£.£aQ££BUE£iSl-££QI!-£iOi:E2!iES«LIl£MI 

WIPEPROC Is a procedure for deleting {w\Q\n§) procedure(s) from 
an SES procedure library. Parameters to HIPEPROC are J 



P or proc s 

fist of Procedures to be deleted frb«n a procedure library. 
Ranges of procedure nawes may also be coded. 



I or b 



(optional) nai^e of procedure Library from Hhlch 
procedurels) are to be deleted. l If you don»t code the I 
parameter^ WIPEPROC uses the value of profile variable 
ptib as the name of the library. If there's no such 
profile variable defined* WIPEPROC uses the name pllb as 
the name of the procedure librarV.t 



nl or nb i 

(optional) naiae of New procedure Library to be created at 
the end of the WIPEPROC run. If you don't code the nl 
parameter* WIPEPROC uses the value of profile variable 
neMpllb as the name of the new procedure library. If 
there's no such profile variable defined* WIPEPROC places 
the new procedure library back aver the old procedure 
library specified by the I parameter. 



un : 

(optional) User Name in whose catalog the procedure 
library specified by l/nl is to b* founds If l/nl Is not 
in the catalog of the current user. If you don't code the 
un parameter* WIPEPROC uses the value of profile variable 
plibown as the user name from whose catalog the procedure 
library is to be obtained* and if there's no such variable 
defined* WIPEPROC uses the current user's catalog. 

lock or nolock i 

these (optional) parameters determine whether the base 
update process Is Interlocked against simultaneous updates? 
coding a filename for the lock parameter determines the 
name of the interlock file. Interlocking is the laliJiit 
action when the base being updated is In another user's 
catalog. If you don't code either of the lock or nolock 
KSilkf interlocking is controlled by the lokmode profile 
variable. Refer to the introductory sections of this 
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chapter for information on the interactions of the iokmode 
profile variable and the lock and nolock paraweters. If 
yoy don*t code a filename for the Idck parai8eter# the 
contents of profile variable Intrfdk Is used as the 
interlock fllenamel if there's no such profile varlabiet 
the name intrlok is used as the lock filename* The 
interlock file liisi be In the saie catalog as the base 
being updated* If the Inter I ock f I I e cannot be found* the 
procedure aborts* 

batch job paranieters > 

These parameters are described in the section entitled 
«SES PROCEDURES RUN AS BATCH 403S". The default for this 
procedure is to run In local fBode> but it can be run In 
batch mode* The dayfile paraiietef Is not used by this 
procedure* 



msg or nomsg % 

these (optional) Ksis control the generation of 
informative messages by this procedure and are fully 
described In the section entitled «INFf3RHATIVE MESSAGES 
FROH SES PROCEDURES"* 
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3.0 £ElMIIIi£-.£Ii£S 



This section covers the facilities for printing files* Most of 
the discussion revolves around the ASCII prlriter* and the SES 
procedures to use the ASCII printer are as described below s 

PRINT prints fileCs> on the ASCII printer tthe "norwal" CDC 
printer Is an option). If necessary* ••carriage control** is 
added to the files before printing CIt Is possible to 
override this automatic determination but It Is very seldom 
necessary to do so)* Choices of character' sets (full ASCII 
or the 64 character ASCII subset) are available* 

PRINTID places "large print** heading banners at the start of a 
printout* tines of title* date and time formats* and 
number of banners are selectable* PRIMTIO Is used by PRINT 
to (optionally) place large print banners at the start of 
the file(s) to be printed* 

COPYSAF gQtl Shifted ASCII £ile* Copies an ASCII file to prepare 
it for printing at a later stage. The file is "shifted** if 
necessary* Character set conversion is also performed as 
required* 

BANNER place "large print" banners of your bin number on the front 
of a printout* BANNER Is used at sites where output is 
placed in "bins"* identified by a bin number* 

FICHE set up list file for microfiche processing* 
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3.0 PRINTING FILES 

3.1 PRINT - PRINT FILECS) 



3.1 £SiMI«r-£EiiI^iL£iii 

PRINT is a powerful facMity for printing one or wore filelsl. 
It looks after the mundane laatters of cNar act er* set conversionsf 
special disposition (route) codes and> oerlitps iiost i siportanti y* 
automatically determining whether each file to be printed has 
already been or needs to be ••formatted'^ for* a printer. 

f or is 

specifies the name of the File* or a list of flies to be 
printed. If the flle<s> are not already focal when PRINT 
is called* PRINT tries to GET or ATTACH the file(s) for 
you. 

copies or € or n 3 

Coptlonal) specifies the Nuwber of Copies of the printout 
you require. If you don*t code the c parareetert PRINT 
produces I (one) copy. 

h or id « 

(optional) specifies the Heading banner to be printed at 
the start of your printout. If you don«t code the h 
parameter^ the first two pages of the printout will have a 
"large print" banner of the file ^laTie. date and time. 

hn or idn t 

(optional) specifies the Number of Headlrig banners to be 
placed at the start of the printout. I** you don't code 
the hn parameter* PRINT produces 2 (two) heading banners. 

shn or sidn 5 

(optional) this parameter is used ^hen printing more than 
one file at a time. When a list of files is printed* 
PRINT outputs a heading banner ^or the whole printout* and 
places a sub heading before each new file Is started. The 
shn parameter specifies the Nunber of Subheading banners 
to be printed before each new file. If you don't code the 
shn parameter* PRINT produces ? (two) subheading banners. 

printer or pr J 

this (optional) parameter specifies on which printer the 

printout is to appear. If you don't C9de this parameter 

or if you specify asfill* the pri?itout Is routed to the 
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3.1 PRINT - PRINT FILECS) 



full ASCII printer. If you specH'y JifiilM* the printout 
Is routed to 6A character ASCII subset printer* If you 
specify &si!^» the printout Is routed to a "normal ♦• CDC 
printer. Any other value for this oarameter Is Illegal. 



bin 



setid 



If you are at a site allowing bin references* printout 
needs some sort of a banner contai'^ing a Sxq Maffll2££> to 
tell operations which Mil to place the output In. 
Printouts without a bin number frequently end up in a bin 
labelled NQS/WO BIN HUH8ER. At the ti^fie of writing, all 
bins have identifiers of the form ilait iiait i£tis£> which 
fljeans you must code the bin oarameter In the form of a 
string* for example* bln»*22a«. The string delimiters aCfi 
required If you don't want SES complaining about invalid 
numbers. If you don't code a bin Par ametsr > PRINT uses the 
value of profile variable userblny ^^4 if there's no such 
profile variable defined* generates a listing banner of 
NO-IO* which almost certainly guarantees that your output 
goes to the NQS/WQ BIN NUMBER bin. 



setid is another site dependent special far sites allowing 
bin references. It your printout Is destined for the 
••normal** (prlnter»cdc) diaaiax Q,2i^ 9rl nter § aat the ASCII 
printer* juil if your printout is large {more than about 100 
pages). 



compres : 

(optional) keyword specifies multlole copies ^re printed 

together on one listing with only one NQS banner. When 

compres Is used the number of heading banners Is defaulted 

to zero unless overridden by sped f I cat Ion of values for hn 
or shn. 



cs612 or cs64 or cs812 s 

these (optional) lifixs can be used to specify the character 
set of the filels) to be printed. If yOu don't code any 
of these keys or If you code the cs612 !sg*Y* the filels) Is 
(are) assumed to be in the NOS 5/12 ASCII character set. 
If you code the cs64 Ii5x* the flle(s) is Care) assumed to 
be in the 64 character ASCII subset or display code 
character set. If you code the cs812 !sgx» the filels) Is 
(are) assumed to be in the '•8 out of 12^ ASCII character 
set. 
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shift Of noshift or cmps ? 

these C opti ooai ) lisis control whether the printout is 
SHIFTed before disposal to the printer. If you don't code 
any of these jss^s* PRINT examines each file to determine 
ho*i to prepare it for printing (I.e. which of these |i§is 
should have been selected). Hatfi * that this automatic 
determination works for the vast ma jor I ty of files and 
that this parameter Is provided for use only in those rare 
cases where the automatic method fails. Note also* that 
the option you select with this parameter applies to all 
files to be printed* and therefore In the automatic case a 
mix of ••shifted" and **unshif ted** files can be printed with 
one procedure call. If you code the shift !i5i# PRINT 
shifts Ci.e. adds "carriage control" characters at the 
left of each line) each file In order to "format" the 
file(s) for printing. If you cods the noshift li&^f PRINT 
assumes each file is already "formatted" for printing and 
therefore does no shifting. The cmps isax is a special 
form of noshift* where any line that contains sail a 1 In 
column one Is deleted* and any line starting with an 
asterisk <♦) in column one Is also deleted. This is 
Intended for printing the output of programs such as 
CQHPASS and CATALOG which try to orint on "prime pages". 
This idea is out of date these days* and the cmps Isfii 
helps save paper. 



date or etad : 

this (optional) K^^ specifies the form In which the DATE 
is to be output on the banner. If you code the date lifii* 
PRINT uses the form 01 AUG* 78* iihlch Is the default. If 
you code the etad lifii* you get the standard system date 
format. 



time or ampn : 

this (optional) is^x specifies the form In which you get 
the TIHE on the banner. If you code the ampfi Isfil* PRINT 
uses the form 4x23 PH* which is the default. If you code 
the time Isfii* you get the standard system time format. 



un 3 



fc J 



(optional) allows you to specify the user* number for a 
printer not at the central site. 



(optional) allows you to specify ^ forms code. 
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3*1 PRINT - PRINT FIIE<S) 

Examples of PRINT Osage 



ses«print Cmyfilef hisfilet tierfllel 
REVERT. END PRINT MYFIiE. .HERFILE 

This example prints three files s iiiyfll%> Hisfile and herf i ie on 
the ASCII printer* The example shows the message that appears at 
the en4 of the print process* 



ses«print forwoyt* c«3* noshift 
REVERT* END PRINT FQRHOUT 

This example prints three copies of the file forwout without 
shifting the file (the noshift K^^) • 
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If you i*lsh» you may establish default options for PRINT by 
setting variables in your PROFILE* The profile variables that print 
uses are defined here* 

copies default number of copies to orint. 

hn default number of heading ba'iners to print at the 

start of a printout* 

shn default number of subheadlnci banner's to print at the 

start of every file In a (Bultl file printout* 

printer default printer to be used* Refer to the fitlatfic 

parameter In the procedure description above* 

Incset default character set of fl1e(sl to be printed* Refer 

to the fis612 parameter described abov»* 

shift sets your default for shifting files or not* Refer to 

the siill Isfil description above* 

userbin used only at sites allowing bin references* userbin 

sets up your default bin number** 

Pflnter^un default user number of a remote printer to be used* 

Refer to the ufl parameter description above* 

printer. fc default forms code to be used* Refer to the ffi 

parameter description above* 

In addition to the profile variables described above* there are 
profile variables that PRINTID uses* See the descr i pt I on of these 
at the end of the PRINTID procedure descrlotion. 

Hstt& * because the userbin profile variable Is [sseti by PRINT* It 
Is also used indirectly by any SES procedure that uses PRINT* 
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userblfi is also ysed by those SES procedyr'es tNat can run In batch. 
If you ran procedures in batchf userbin Is used to place bin number 
banners on the batch Job output. 
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3,2 PRINTIO - PRINT "LARGE PRINT" HEADING BANNERS 

PRINTIO is mainly used as a building block for other procedures. 
It produces a "large print" heading ba^?^er» that occupies a full 
page* using a program called JOBID which is described in an appendix 
to this document. Parameters to PRINTIO ar% s 

h or id s 

this para«Reter pay foe any arbitrary character string which 

specifies the text to be output. The string used can be 

anything that's legal for the JOBID urogram* 

copies or c or n or hn or I dn s 

(optional) Number of COPIES of the banner that you want 
output. If you don't code the copies parameter:* PRINTIO 
produces two (2) copies. 

o or output 2 

(optional) name of file to vihich the banner Is to be 
Output. If you don't code the o paraiieterf PRINTIO uses 
file OUTPUT. 



date or etad : 

this (optional) Isfi^ specifies the form In which the DATE 
is to be output on the banner. If you code the date ksit^ 
PRINTIO uses the form 01 AUG* 78# which is the default. 
If you code the etad lifiif you get the standard system date 
f orwat. 



time or ampm : 

this (optional) Is^x specifies the form in which you get 
the TIME on the banner. If you code the afflpm ls£lf PRINTIO 
uses the form 4:23 PH* which Is the default. If you code 
the ti«e 1ijB1# you get the standard systei time format. 

cs612 or cs64 or cs812 : 

these (optional) li5XS specify the character set in which 
PRINTIO output is to appear. If you don*t code any of 
these lifixa or If you code the cs64 jsfi^* output Is in the 
64 character ASCII subset (can also be thought of as 
display code) character set. If you code the cs612 isfi^* 
output is in the NQS 6/12 ASCII character set (since 
PRINTIO output does not include any of the so-called 
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extended characters* cs612 is effectively equivalent to 
C$64 for this procedure)* If you code the csdl2 ^ttf 
output Is in the »B out of !?♦• ASCII character set* 
^SlSi 5 that Hhen PRINTIO Is called by the PRINT 

procedure* that this paraweter Is set according to the 
destination printer; the PRINT procedure has a parameter 
Mith these keys and it refers to the character set of the 
fileCs) to be printed* 

Note that the djjtf and lifflfi parameters only have effect when the 

ll parameter is specified as a name* If you give the jj parameter as 

something other than a name* it is up to you to Include the date and 
time in the heading if you want it* 



Example of PRINTIO Usage 

ses.prlntid i d«»flnal /debug/document'* O'banner 
REVERT* END PRINTIO BANNER 

This example shows a title banner being formatted onto a file 
called banner* 
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You can establish defaults for varloas PRINTID parameters by 
coding them in your PROFILE. The profile variables are described 
here. Also refer to the PRINT profile variables. 

myld is a character string specifying the default format for 

heading banners. For complete ur»ders tandl ng of the 

foilonlng description refer to the documentation for the 
J08I0 program (Mhlch produces the banners) and to the SES 
Procedure Writer's Guide. 

The default heading banner format would be defined via this 
profile variable as follovis s 

V myid «»« •/••^^-VALSChl^** «//)• »**mydate4-4-» «//!« «*4»ytime« 

Other heading banner formats can be constructed In an 
analogous manner. To eliminate heading banners altogether 
< as the default case) you should code the following line in 
your prof I le s 

\ «yld « NO 

Note that in order to produce a heading banner* the length 
of the string assigned to the myld variable must be at 
least 4 (four). 

mydate Is a character string containing your version of the date. 
Refer to the iljatfi lifiX 1^ the procedure description above. 

nytine is a character string containing your version of the time. 
Refer to the tlafi k^l In the procedure description above. 

outcset can be used to specify the default character set for 
PRINTIO output. Refer to the sa^i iiS3t In the procedure 
description above. Note that this variable has no effect 
when PRINTID Is being called by the PRINT procedure. 
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3.3 COPYSAF - COPY SHIFTED ASCII FILE TO PREPARE ^QR PRINTER 

COPYSAF prepares a file for printing on the NOS ASCII printer. 

The file in question is converted to the ASCIIS character set If 

required* and shifted (carriage control addled) If required. 

P^rBmetets to COPYSAF are s 



I or f 



name of Input £ile to be prepared for the printer. 



(optional) nawe of file to receive the Qutput from COPYSAF. 
If you don't code the o pararaeter* the output appears on 
the file specified by the I parameter. 

Incset or Ic 3 

(optional) designator for the I?^put file's Character SET. 
The table belo« describes the allayed designators* 



outcset or oc s 

(optional) designator for the OJTout file's Character SET. 
The table beloM describes the allowed designators. 



shift or nosNift or c»ps ? 

these (optional! i£SX5 control whether the printout Is 
SHIFTed before conversion. If you don*t code any of these 
li£H> COPYSAF examines the file to determine how to 
prepare It for printing (that is» which of these h&XS. 
should have been selected). Hats * that this autoiaatlc 
determination works for the vast najorlty of files and 
that this parameter Is provided for use only In those rare 
cases where the automatic fnethod falls. If you code the 
shift iss)t# COPYSAF shifts (that Isf adds "carriage 
control" characters at the left of each line) the file in 
order to "format" the file for orintlng.i If you code the 
noshift Kfi^f COPYSAF assumes the file is already 
"formatted" for printing and therefore does no shifting. 
The c«ps iifii is a special form of noshlft» where any line 
that contains filil^ a 1 in coluitn one Is deleted* and any 
line starting with an asterisk (*) In column one is also 
deleted. This is intended for orlnting the output of 
programs such as COMPASS and CATALIG which try to print on 
"prime pages". This idea Is out of date these days* and 
the cmps iisi helps save trees. 
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3.3 COPYSAF - COPY SHIFTED ASCII FILE TO PREPARE FflR PRINTER 



The Incset parameter has a default of cs612 CMOS 6-12 character 
set) and the outcset paraiseter defaults to cs812 (ASCII character 
set suitable for the NOS ASCII prlnter)> as described ih the table 
below* but these defaults can be overridden by defining in your 
profile defaults via variables with naies the sawe as the 
parameters* The following table defines the allowed designators for 
the Incset and outcset parameters s 



4,-.«— -«™^-.«, — «.««+«—.««« — -.^-.— ^, — ^. «. — « — . ^ ^ ^^^- — 

t • 

• BssiiiaaiaL * Mia alas 

• t 

« « 

\ GSblZ \ NOS 5/12 ASCII character set 
« • 


1 < 

* t 

\ cs64 S 64 character ASCII subset C display code) 

? 1 character set 
« 1 

* i 

1 CS812 J «8 out of 12" ASCII character set 

« t 
t « 



+«. <- ^ . ^ 
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3.3 COPYSAF - COPY SHIFTED ASCII FILE TO^REPARE FOR PRINTER 



Exafiples of CQPYSAF Usage 



ses.copysaf listingf topressf noshift 
REVERT. EHD COf»YSAF LISTING -> TOPRESS 



ses.copysaf outfiie# cs64 
REVERT. END COPYSAF OUTFILE 

The first exaiaple of COPYSAF converts the file fisting frofu the 
6-12 character set to the 8-12 character set* placing the result on 
file topress* The noshlft Im ensures that the file is not shifted 
during the conversion. The second example Is converting a display 
code file to the 8-12 character set ready for printing* and CQPYSAF 
determines whether to add carriage control to the file. 
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3»0 PRINTING FItES 

3.4 BANNER - WRITE BIN NUMBER ON LARGE PRINT BANNER PAGE 



3 . 4 iMi££-r^MaiI£.iIM-MyMMS«QM-L4ES£.£EIlI-lMl£E^liiiI 



This procedure Is a special form of the PRINTIO procedure for use 
by sites allOMlng bin references to identify printed output. 

BANNER is intended for writing the yser*s bin number on a large 
print banner page (actually it produces two paries of banner) on 
printouts or in the dayfile of a batch Job. BANNER produces two 
pages with your bin number arranged in a ^gaoinetr I ca I pattern that 
makes it easy for the process control persons to see. BANNER 
outputs the page in different patterns depending on the number of 
characters In your bin number. Parameters to the BANNER procedure 
are s 



bin 



is your (optional) bin number. This mast be specified in 
the form of a string* for exai?pief blnp'OlSd*. If you 
don't code the bin parameter* BANNER uses the value of 
profile variable userbin* and if there's no such profile 
variable defined* generates a bin number of NO-ID. 



or output i 
is the 
to be 
banner 



(optional) name of the fife on uhlch the banner is 

written. If you don't cade the o parameter* the 

appears on file output by default* making this a 



convenient default for batch jobs. 



Examples of BANNER Usage 



ses«banner 

REVERT. END BANNER 



ses«banner 
REVERT. 



bln«n3b»* 

END BANNER 



o«tempout 
TEMPOUT 



The first example shows the simplest use of BANNER with the 
banner going to file output* and the bin number either obtained from 
the userbin variable In the profile* or the default NO-IO generated. 
The second example shows how to code the bin number parameter on the 
procedure I ine. 
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3«4 BANNER - WRITE BIN NUMBER ON LARGE PRINT BANNER PAGE 

The only PROFILE varitble used by BANNER Is ? 
yserbin defines your output ••bin" identifier as a cNeracter string. 

tlllt£ ' that the userbin profile variable Is also used by PRINT* 
and thus Indirectly by any SES procedure tNat uses PRINT* userbin 
is aiso used by those SES procedures that can run in batch. If you 
run procedures in batch* userbin is used ta place bin number banners 
on the batch job output. 
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3.5 FICHE - SET UP LIST FILE FOR HICROFICHE PROCESSING 

3 • 5 £KiJ£^z.S£I.y£,JLIlI-£lLJE-£fl£«MI£BQEK!iE.ES12i:iISlMi 

FICHE accepts an input file consisting of CYSfl* 180 Assembler* 
HETA Assembler or COMPASS code and writes It to a tape in a format 
suitable for laicrofiche processing at Cosnsourbe Headquarters* For 
any laodule name encountered in tlie listlfig file* i banner page will 
be generated^ for visual aid on the fflicroficbe* and It «lll ^ppenr 
in the Index of the microfiche. The tape j*hlch is wade froai running 
FICHE should be sent with a 'Mlcrofllffi '4or1< Request* (form no. 
AA5167) to Terry Larson - HQCOOH. The 'Progr ai I0« used on the 
•HIcroflliii york Request' is ARH1833. A 'faster Charge Ho.« will 
also be required to submit this *HI crof I f n l^ork Request'. Please 
contact Kathy Beatty (482-2338) for Infor^nation needed to acquire a 
•Master Charge No.* Parameters to the FICHE procedure are s 

i 1st or I : 

name of the list file to be used as Input.! 



id 



fiche Id title which will appear at the top of the 
microfiche. The id supplied should be a string limited to 
no more that 38 characters. 



tapevsn or vsn i 

number of the tape to be used for the output of FICHE. 



Example of FICHE Usage 
ses.flche l«uiist id«*ses utilities* \rsn«ses01& 

This example shows the input file ullst being used to generate a 
fiche from the output contained on the tape ysn ses016. The title 
at the top of the fiche when it comes back from processing will be 
ses utilities* 
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4 . l2a£iJa£MI.£QIIllIIlMS«SIlIIi 



The documentation formatting syste« is a pov»erfiil set of programs 
that can produce documents from unformatted source text» containing 
directives to control «argin allgnmentt itesfiizfng* tables and so on« 
There are facilities to compare two yerslons of a document to 
generate revision bars to indicate changes* and facilities to change 
heading formats and so on* 

The major components of the documentation system are two 
processors called TXTCOOE and TXTFORN. TXTC3DE is In fact a high 
level preprocessor for TXTEORH. Type SES.TOOLBOC to reference the 
manuals that describe TXTCOOE and TXTF0R?1» 



After the main descriptions of FQRHAT and FORHRS^> there are a 
number of "data flow diagrams" showing the orocesses that are run by 
coding different parameter combinations on a FORHAT or a FORHREV 
procedure usage* 

FORMAT runs the complete document formatting system in all its 

manifestations and options* while the rest of the 

procedures described after FORMAT are the Individual 
components of the system* 

FORHREV runs the document formatting systeni to generate a revision 
package* complete with change pages and change directive 
summary* 

SPELL produces a list of suspected misspelled words from a text 
file. 



GRAOLVL computes the reading difficulty of a document. 

TWQRASE places two formatted document pages on one printer page* 

OIAGRAH aids the construction of block diagrams such as those found 
later in this section* 



4-2 
COC - SOFTl^ARE ENGINEERING SERVICES 

18 OecBmber 84 
SiS User's Handbook REVs 4A 

4.0 OOCUHENT FORHATTING SYSTEM 



MEMO produces a standard forwat memo* 

TXTCODE runs the higl^ level preprocessor for TXTF9RM* 

TXTFORM produces a formatted document* 

TXTHEAO a TXTFORM post processor i«hich changes treading banners on 
document pages* 

GENREVB works in conjunction with TXTFORM to farmat a document with 
revision bars down the right side of the page to show 
changes from a previous document* 

GENREVP builds a revision package by con^arlng the output of two 
formatted documents* 
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^ 



4 . 1 £0£MI^r.SyM-Sfl£yfiIMI^QEMIIIliiS.SXlI£l 

FORMAT produces a formatted document either fro« TXTCOOE source 

<the defauit)f or from TXTFORM source. FORHAT normal J y runs in 

batch rather than i nter act I vely* but you can run FORMAT at the 

terminal If you wish* by coding the local lia^ when you run It. It 

Is usually better to run the document formatters i?^ batch since they 
consume some time. Parameters to FORMAT are s 



i or f s 

name of Input File containing source data to be formatted 
by TXTFORM or TXTCOOE. 

b or old s 

Coptlonal) name of file contalnfi^g a Base or OLD version 
of the document source* If you code the b parameter* 
FORMAT compares the files specified! by b and I such that 
revision bars are printed on the formatted output 
document. 



I or listing i 

{optional} name of file to receive the output of the 
formatter in a form suitable for orlntlng on the ASCII 
printer. If you don't code the I parameter* and you're 
running FORMAT LOCAt at your teminalf the output appears 
on a file called listing. 



d or display : 

Coptionai) name of file to receive the output of FORMAT In 
a form suitable for DISPLAYIna at a terminal* that Is* the 
formatted document is truncated for a terminal screen. If 
you don't code the d parameter* FORMAT doesn't produce any 
display file (unless you code the k parameter described 
below) . 



batch Job parameters : 

These parameters are described In the section entitled 
«SES PROCEDURES RUN AS BATCH JOBS". The default for this 
procedure is to run in batchn node* but It can be run in 
local mode. The dayfite parameter Is used by this 
procedure. 
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4.1 FORHAT - RUN OQCUHiNT FORMATTING SYSTfc^l 



print 



{optionai) controls the action ^f the PRINT procedure* 
used to print the output of FORMAT. If you run FORMAT as 
a batch job (the default case) and you don't code the 
print paraiaeter^ FORHAT prints one CI) copy of the 
document on the ASCII printer. If you run fORHAT in local 
mode or "while you walt'Vt FORMAT does not pr int any copies 
of the docui^ent. For a coiupl ete descrl pti on of the values 
that may be coded for the print parameterf see the 
description of procedure PRINT. 



s or source s 

this loptionaU |i^i specifies that the SOURCE of the 
document is to be printed in addition to the formatted 
output. If you don't code the s iSSY* the source isn't 



printed. 



k or keepout : 

(optional) t\^me of file in which to KEEP the OUTput of 
FORMAT. You can use thi s faci 11 ty where you may want to 
run many copies of a document at a later date. If there's 
no file of name specified by the k parameter in your 
catalog* FORMAT places the output In a DIRECT access file 
of the specified name. If such a file already exists* 
FORMAT overwrites It with the output of the run. 

Iiat£ 2 that if you code the k parameter* FORMAT produces a 
display file (see above) and saves that* rather than saving 
the full size listing file which Is usually large. 



code or form or txtcode or txtform : 

these (optional) KfiiS determine s^hich formatter is to be 
used by FORMAT to process the document source. If you 
don't code any of these isfi^i* FORMAT runs the TXTCODE 
process* which is the same as if you coded the code or 
txtcode k5X5« I^ you code the form or txtforw ii£x* FORMAT 
runs the TXTFORM process. Note* you can change the 
default selection by defining In your oroflle a variable 
called FORMAT and setting its value to 'TXTFORM' or 
•FORM'. 

head or txthead i 

this (optional) lifijt invokes TXTHSAO* a special 
postprocessor for the document formatting system. TXTHEAD 
is used to change the headings that appear at the top of 
the document pages* where the standard headings are 
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inappropriate* Oocuwentat Ion for* TXTHEAD can be found in 
an appendix to this User Handbook, If you code the head 
MSl* FORMAT runs TXTHEAD. 

tMOpag^ • 

this (optional) parameter* If coded* directs FORMAT to run 
the TWQPAGE procedure (described In this chapter) which 
places two pages on one printer page. Since the iBaximuin 
width of a printer pa^e Is 135 colu'^nst If you happen to 
have wide platen docuinentSf the output tends to look rather 
strange* so for effective use of t^opage* your documents 
should be less than 68 columns wide. twopa^e may be coded 
just as a Js.s,^» or it ifiay have a list of valuest namely the 
pw parameter and the seq fisx* as M the description of the 
TVIOPAGE procedure later In this chapter. 

tidi£ • that the twopage option aalx a^^ects the fi£iQl£ii 
copy of the output. The actual data In the files specified 
by the d or I parameters Is not affected. 



msg or nomsg : 

these (optional) isfiis control the generation of 
informative messages by this procedure and are fully 
described in the section entitled ^'INFORMATIVE MESSAGES 
FROM SES PROCEDURES". 



backup 



this (optional) Isfii specifies that the source is to be 

processed by the old processor (TEXTCODf/TEXTFORM). If 

you don't code the backup Isfijti ^^ORMAT uses the new 
processor (TEXTPRO). 
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4«1 FORMAT - RUN OQCUHEMT FORMATTING SYSTEM 

Examples of FORMAT Us^ge 

ses«foffliat Riyfile 

17.42«55« SUBMIT COMPLETE. JQ8NAME IS ADC981IG 
REVERT. JOB FORMAT SUBMITTED 

This Is the very siBiplest example of using FORMAT* myflle 
contains document source written in TXTC1DE form*i The document Is 
processed by FORMAT* and one CD copy Is orlnted on the ASCII 
Pf inter. FORMAT runs as a batch job* freeing up your terminal for 
further processing. 

ses.format newflte* oldflie* pr int*{c«2>h*nol* s* jobtl»4000C8) 

13.32.55. SUBMIT COMPLETE. JOBNAME IS AOUOlSOS 
REVERT. JOB FORMAT SUBMITTED 

This example is more cosnplex. The fMas newfile and oldflle 
contain respectively the latest and previous versions of a document. 
Both versions are coded in TXTCQOE form* Fl^MAT processes both lots 
of source* uses the revision bar generator to generate change bars 
on the final document. The source of newflle Is printed because the 
£ h.S.X is coded on the call fine. It*s assusned that the documents 
are large and require lots of computer tlie to process them* so 
iobtl«4000(8} is coded to give FORMAT twice the normal time. 
Finally* the print parameter specifies that tiio iZ) copies are to be 
printed with no heading banners. 

ses. format i«newfllef b^oldfile* txtfor'n* pr1nt«c«4 

11.35.43. SUBMIT COMPLETE. 40BNAME IS ADRICAD 
REVERT. JOB FORMAT SUBMITTED 

This example shows FORMAT used to fomat the document newflle^ 
with oldfile as the base version for generating revision bars. The 
txtforn Mfii indicates that the source of the two documents is In 
TXTFORM format* and so the TXTCODE stage of FOR^IAT is bypassed. 
Finally* four (4) copies of the output are orlnted* because of the 
prlnt«c«4 parameter. This last parameter indicates how the print 
parameter Is coded when it has only one suboaraneter in its list* as 
opposed to the example above* where the print parameter has two 
subpar ameters in Its list* so that they uust be enclosed in 
parentheses. 
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seSi 


•format i* grab age local prini 


t d«loo!csee 




* 


RUNNING TXTCOD€ ON 
RUNNING TXTFORM 


GRA8AGE 






♦ 


FORMATTED DOCUMENT 


ON FILE 


LISTING 




» 


PRINTING LISTING 








* 


CREATING DISPLAYABIE DOCUMENT iOO<SE€ 




REVERT. END FORMAT ( 


SRABAGe • 


-> LISTING 


LOOKS EE 



This example shOi«s how to use FORMAT at the ter^lr^alf or ••while 
you waif^. The file grabage Is assumed to coritafn the source of a 
docuaent in TXTCODE form. FORMAT runs while you wait because the 
local Kn is coded. FORMAT places the foriiatted document on a file 
called listing and prj jits one <^^ CQ^yof^ ^^ t Q^ the ASCII prin ter 
tjig ^ause the ^ Pfjnt 'kS wa s sp-glTfT T e dFT The file called looksee 
contains a copy of the "fOfmStted document suitable for displaying at 
a terminal. The example shows the informative messages output by 
FORMAT to reassure you that there's something going on. 

ses.format draft batch twopage»seq 

12.10.30. SUBMIT COMPLETE. JQBNAME IS AMTBS08 
REVERT. JOB FORMAT SUBMITTED 

This example shows the twopage option used to double up on the 
printed output* 
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4*1 FORMAT - RUN OQCUHENT FORMATTING SYSTEM 



Sjia-£laM-af«£QIiAI,£i:aiisiMLiBS 



ses.forniat i«anyfile 

« 



ses»foriat 



l«afiyf 1 1 ey 



txtfor« 



I TXTCOOE 
5 OQCUHENT 
r FORNATTER 

« 



— + 



TXTCOOE Is a 

<- PREprocessor 

for TXTFORH 



Codlfit tNe 
causes the 
the Input 
processed 

TXTFORN. 



J/ 

-I- 






txtfom key 
contents of 
file to be 
directly by 






1 TXTFORH I 
J OOCUMENT J ^ 
i FORHATTER t/ 



4. -.-™™.— «4. 

TXfFdRH 
DOCUMENT 
FORHATTER 



/ 






PRINT 






-> TO 
PRINTER <— 



I 



? / 



P«IilT 



.-«♦ 



The diagram shows two of the ways that FORMAT cari run> depending 
on the options you code* The left hand diagraii shows the normal and 
simplest case of FORHAT. The right hand dlagra?n shows that coding 
the txtforw or form Jss^ eliminates the TXT^ODE urbcess* 
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ses«forniat l«ne»ifHe» b«ofdflle 



this processes "newflfe* 



this does "oiaflle* 



/ ? /I 

TXTCODE S 5 
OOCUHEHT J ♦ 
FORNATTER 5/ 






GENERATE 

REVISION 

BARS 



U 



I 1 /I 

r TXfC^DE S 



! FOR NATTER M 



/ % l\ 

\ TXTFORM S \ 



X FORHATTER 5/ 




— > TO PRINTER 






This diagram shows the action taken when you run FORMAT with a 
current docunent and a "base" version of the document. The revision 
bar generator compares the two files altgt* TXTCODE has processed 
theni* and generates the cofnmands such that TXTFORM knows where to 
place revision bars in the final document. 
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ses«fof»at myflle source 









/ 

4~' 



—■ I- 












pRim 



FORHATTER J/ 

/ J / 

TXTFQRH S 

OOCUHENT f ♦ 

FORMATTER S/ 



4.~ 



« 



TO 
f^RINTfR 



— I- 
/ 






PRINT 






> T3 PRINTER 



This diagram shows what happens when you run FORMAT and code the 
source !i5i» The source of the document is pr'inted directly^ then 
the formatting process takes place to produce a formatted document* 
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FORMREV is Intended to format documents and run the GENREVP 
package described latert to produce a r'eyfslan package for a 
document. FORHREV uses the FORMAT and GHMRFVF procedures in a 
manner suitable for most of the stafidard day to day document 
applications* If you have any coisplicated situatlans you sliould use 
FORMAT and GENREVP ••manual I y»» to cater for the situation you want* 
Parameters to FORMREV are i 



i or f or nen s 

name of NEW Input Fife containing the new document source 
to be processed by FORMREV. 



b or old i 

loptional) name of fife containing OIB document source to 
be processed by FORMREV* If you don»t code this b 
parameter* you should supply t^e file soeclfied by the r 
parameter* 



r or rllst s 

(optional) name of file containing the output of a 
previous FORMAT run* If you don't code the r parameter* 
you should supply the file specified by the b parameter* 
Of course* both b and r may be coded* 

1 or listing < 

(optional) name of file to receive the listing of the 
selected pages after the comparison* If you don't code 
the I parameter* FORMREV uses file listing* 



s or summary t 

(optional) name of file to r'ecelve the summary of the 
changes* and a "how to update the document** description* 
If you don't code the s parasneter* FORMREV uses file 
summary* 



or output : 

(optional) name of file to receive the OUTPUT of FORMREV* 
The output file contains error* uess ages and statistics* 
If you don't code the o parameter* FORMREV attempts to use 
PROFILE variable output* and If such a variable doesn't 
exist* file output is used* 
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batch Job parameters^ 

These parameters are described } r% the section entitled 
«SES PROCEDURES RUN AS BATCH 409S", The default for this 
procedure is to run In batohn iiodet bat it can be run In 
local mode* The dayfile parameter Is used by this 
procedure* 



print 



(optional) parameter list (as for the PRINT procedure) 
which controls the PRINTing of the II s and o files* If 
you run this procedure In local' «ode* no printing Is 
performed* If you run this as a batch Job» the default 
action Is to print one (13 copy of those files* 



format or fornatl s 

(optional) list of paraneters to control the FORMAT run 
that produces the new version of the text* The parameters 
are as for the FORMAT procedure described previously* 



foraiat2 



genrevp 



(optional) list of parameters that control the FORMAT run 
that produces the old version of the text* in the case 
that the r parameter wasn't coded** The oaraweters are as 
for the FORMAT procedure described previously* 



(optional) list of parameters that control the actions of 
the GEHREVP procedure described below* when GENREVP is 
called into play during the run of FORMRFV to produce the 
final output listings* The paraieters are as for GENREVP 
described below* 



msg or noiRsg : 

these (optional) lisis. control the generation of 
informative messages by this procedure and are fully 
described In the section entitled "INFORMATIVE MESSAGES 
FROM SES PROCEDURES'^* 
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Exanpies of FORHREV l}sa<ie 

ses.fornrev i«nei«ctoc» b«ol<ldoc 

09.45.34. SUBHIT COHPiETE. J08NAME IS AEXICOS 
REVERT. JOB FORHREV SUBHITTEO 

This example shows FORHREV used to generate a revision package by 
comparing nendoc (the current version) »iith ofddoc (the previous 
version). FORHREV produces a printout consisting of those pages 
Mhich differ between the two docuaents* and a summary indicating 
*#hlch pages are changed. The changed pages hav« revision bars 
against those lines that differ. 

ses.foriirev neiidocy r«oidiistf foraat«txtf ormy jobtl«5000l8) 

14.4S.S6. SUBNIT COMPLETE. J08NAHE IS JACIBHI 
REVERT. JOB FORHREV SUBMITTED 

This example generates a revision oackage by comparing the 
results of formatting the current documeit newdoc with the old 
listing file oldtist* The formatting process Is to be done with the 
TXTFORH formatter* bypassing the TXTCQOE process^ as indicated by 
the format'txtform parameter. The Job time limit is set to 5000 
seconds (octal) by the Jobti*5000(81 parameter. 

ses.formrev isciirrefit# b«dated# genrevi>«Chow«c9mfj ley folio) 

16.32.48. SUBMIT COMPLETE. JOBNAME IS AFTX80D 
REVERT. JOB FORHREV SUBMITTED 

This example shows FORHREV used to generate a change package for 
the documents current and dated. The portions of the listing pages 
that are to be Ignored are not the standard ones normally used by 
the GENREVP procedure^ so the genrevp parameter Is coded to indicate 
that the directives are on file eomflie* and that the folio line 
(indicated by the folio Kll) is also to be Ignored for the purpose 
of comparison. 
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Oata.£liiM.af»£QEi££i^£i:&££iiM££ii 



ses»forMfey l«neiifilef 

a 



b««!dfl1e 






/ S /I 

r TXTCOOE 5 S 






/I 



FORMATTER • 






TXTCOOE 1 

DOCUHENT S 

FORMATTER S- 



t 



TKfC90E 
DOCUHENT 
FORMATTER 



/S 



s/ 






GENERATE 

REVISION 

BARS 



The diagram shows hoM 
FORMREV processes a 
current version of a 
docuiient# and an old 
version of the sane 
docunentf to generate 
a change package nith 
revision bars on the 
changed pages* 



/ S 

I TXTFORM I 
I DOCUMENT 5 
5 FORMATTER 






4.—-.—™—, 

I GENERATE 
i REVISION 
I PACKAGE 



—.4. 
/S 

U 



•I—- 
/ 

TXTFORM 

DOCUHENT 
FORMATTER 









.—4. 



PRINT 



n 

5 

-I' 



-> TO PRINTER 
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4.2 FORHREV - FORHAT A REVISION PACKAGE FR3f1 OOCUMEMT SOURCE 



ses.forwrev i»neMfile# b«ofdfil%t r^ofdllst 



/ t I 

X TXTCODE I 

r oocunEHT \ 



4. «—+•„— .-4. 
/ % / 

TXTCODE \ 
OOCUHENT J ♦ 
FORMATTER 1/ 



— + 



/ \ 

GENERATE !<♦' 
REVISION X ♦ 
BARS 






TXTFORN X 
OOCUHENT X ♦ 
FORMATTER XI 

•t- — ♦ 






-♦— - 



—4 
/ 



GENERA 
REVISI 

PACKAG 



.^-4., 



4.— 



TE X 
ON X 
E Xf 



fX 
— ♦ 5 



TO 
PRINTER 



PRIPIT 






This diagram shows FORMREV used to generate a revision package 
where all three forws of the document are used t the current 
version of the document* neMfiie* the old version of the document 
source* oldfiie* and the old document listing* oldiist. In 
case* FORMREV uses the old listing as the base against 
compare the processed version of the new document, 
document source was used as well* the change 
FORMREV have revision bars on them. 



this 

which to 

Because the old 

pages produced by 
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4.2 FORMREV - FORMAT A REVISION PACKAGE FRO^ DOCUMENT SOURCE 



ses.f ormrev l^nenfllef r'»oldMst 






^^ +«™ — ^ 

I I / 

TXTCOOE \ 
DOCUHENT \ ♦ 
FORMATTER 5/ 



/ S / 

TXTFORH 5 

DOCUMENT I 

FORMATTER M 



..-.+ 



—• I- 
/ 









4.—. 






GENERATE \ 
REVISION \ 
PACKAGE \f 

I 



/ 



PRINT 



5- 

J 

5/ 



•> T3 PRINTER 



This diagram shows the simplest use of FO^HREV. The current 
version of the document is conapared with the old listing of the 
document in order to generate a change pac^oge. I'^ this case there 
are no revision bars generated on the final output since there was 
no old document source given to FORMREV to be processed. 
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4.3 SPELL « CHECK FILE FOR SPELLING HISTA<ES 

SPELL checks for nords In a docu^er^t that are spelled 
Incorrectly. Parameters to SPELL are s 

I or f s 

naise of Input File to be checked for spelling fulstakes. 



(optional) name of the file to racefve the Output frost 
SPELL. If you don't code the o oaraieter^ SPELL uses file 
OUTPUT. 



di ct or d i 

(optional) name of a file contalrilng words (one per line* 
left justified* all letters in u5>oer case) that are to be 
used in conjunction with standard "iJl^siionary" used by 
SPELL* If you don't code this parameter* SPELL uses only 
the standard dictionary (containing approximately 50000 
«ords) when checking for jnlsspellfed worlds. ^ 

dictun or dun t 

(optional) Username In whose catalog the additional 
dictionary specified by diet is found. The default Is the 
current user's catalog. 



to : 

(optional) List options available for output format. 
brief* the default* displays three columns containing each 
••dispelled" word* the input file line number at which the 
word was first encountered* and the number of subsequent 
references of that word in the text. 

full is a proof reader's format. The entire text line 
containing the "misspelled** word is orinted out and the 
word in question is "flagged" on every occurrence. 

batch Job parameters i 

These parameters are described In the section entitled 
"SES PROCEDURES RUN AS BATCH JOBS". The default for this 
procedure is to run In local node* but It can be run In 
batch mode. The dayfile parameter is not used by this 
procedure. 
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4,3 SPELt - CHECK FILE FOR SPELLING MISTAKES 



msg or nomsg t 

These CoptionaH Mfi^S 

i nf or mat ive messages by 
described in the section 

EROH SES i>RGC£DllRES«». 



control the generation of 

this proceflur'e and are fully 

entitled "INFORMATIVE MESSAGES 



Examples of SPELL Usage 



ses*spei I 
REVERT, 



neudoc 
END SPELL 



HEUDOC 



This example shows the simplest use of SPELL. A list of the 
words In file NEWOOC that are suspected to be (iiTsspeMed along with 
a count of the number of times each occurs Is written to file 
OUTPUT. Only the standard dictionary was used since the diet 
parameter was omitted. 



ses«speil issomedocy dict^Jargont o'baddies 
REVERT. END SPELL SOWEDOC 

This example shows SPELL applied to a fife called SOflEDOC with 
additional words from dictionary file JARSO?!. The output of SPELL 
appears on file BADDIES. 
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4.4 GRAOLVt - DETERHINES READING LEVEL Qf ^ DOCUMENT 

GRAOLVL reads the input file and coaiputas the reading difficulty 
of the document. Difficulty is expressed In teriBs of the U«S» 
grade level that wouid find the document understandable. Two 
reading level roeasuriuents Bre computed* the Plesch and the KIncaid. 
In general* the Elesch measure will report a slightly higher grade 
levei than the KIncaid. For technical fliaterlalf the KIncaid value 
is probably more accurate* The •hical* option will provide a list 
of document words of three or more syllables on the output file. If 
the reading level of your document Is too high* try substituting 
simpler words* Parameters to GRAOLVL are ? 



i or f 



o i 



name of Input file containing text to coioute the reading 
diff i culty of. 



(optlonall name of file to receive the output of GRADLVL. 
If you don't code the o paraiieter* GRAOLVL uses file 



OUTPUT. 
Incset • 



Coptional) designator for the IN»tit f i I e»'s Char acter SET* 
The table below describes the aMov*ed designators. 



outcset t 

(optional) designator for the OUTojt file's Character SET* 
The table below describes the allowed designators. 

hical 3 

(optional) li£i provides a list of document words of three 
or more syllables on the output file. 

Both the Incset and outcset parameters default to s's^i£ (see below). 
The following table defines the allowed designators for the Incset 
and outcset parameters : 
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4.4 SRADLVt - OETERHINES READING lEVEl OF? 4 OQCUHENT 



>— 



1 

• 

• 
« 

CS612 I HOS 6/12 ASCII character set 

* 

. » — -._«._^__ _ ___i .__ 


S 
cs64 1 64 character ASCII subset {display code) 

1 character set 

< 
1 

+ . ^-. -. — ^^«, ^ ., — ^ — « 

• 

CS812 } "S out of 12" ASCII character set 

« 
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4.5 TWORAGE - RRINT TWO OOCUHENT PAGES SIDE BY SIDE 



4*5 IMQ£4££^=,££IMI-IMa-fiQi:ilM£iI-.£iiS£l-iiai:.iY:.llM 

TyOPAGE takes the output of any of the tsxt processors and places 
two output pages on one printer page. This reduces both paper usage 
M£k^ print tinie» which is invaluable while docuirents are in their 
developwent stages and being turned around fast.! 

The Input for TyORAGE wust be In 8 of 12? ASCII format and aai «n 
NOS 6/12 ASCII* Its output is also in 8 of 12 ASCII. Paraipeters to 
TWOPAGE are s 



I or f 



o I 



name of input file to be processed by TVfO^AGE. 



Coptionall name of Qutput file fr'on TWOPASE* If you don«t 
code the o parameter* the output appears on a file of the 
same naine as the input file specified by the i parameter. 



pif or width * 

(optional) £age Midth of the output pages. If you don't 
code the pw parameter* TWOPAGE uses a default page width of 
137 C136 columns plus one column of carriage control). 
Remember to cater for the carriage control column when 
specifying the page width. 



seq 



this loptional) Isjsi indicates that i£2uence numbers are to 
be placed on the final printout.! The sequence numbers 
appear down the center of the printer page between the two 
document pages. Oefault action In the absence of the seq 
lS51 is no sequence numbers. 
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4,5 TWQPAGE - PRINT TWO DOCUMENT PAGES SIDE BY SIDE 



Examples of TWQPA6E Usage 



ses«ttfopa9e i'textoutf o^listing^ set 
REVERT* END TiOPAGE TEXTOUT -> LISTING 



ses«tMOpage forfliatd 

REVERT, END TWQPAGE EORWATD 
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4.0 DOCUHENT FORHATTING SYSTEH 
4.6 DIAGRAM - OIAGRAH DRAWING AID 



^ . 6 aiASE AE^r^filAMia^DEi MIMS.AID 



OIAGRAH IS a documentation aid for drawing liatir'aros. The "data 
flow diagrams" in this section of the SES User's Handbook were drawn 
using OIAGRAH* Baslcaify» a page is conslierad as a three colynin# 
five row grid* into which you can place various shapes* You still 
have to do soiae manual editing to join lines and add text# but the 
bulk of the pain of drawing the shapes Is done for you* Shapes 
available via OIAGRAH are those shown beltiw* with theiir ••names'* 
given for reference. 



"BLANK'' 



'CONN' 



J ••BOX* 
• 

f xxxxxxxxxxxxx * 
I xxxxxxxxxxxxx • 
; xxxxxxxxxxxxx * 



IN' 



5 "CONO*' 

/ \ 

^ — — i \ 

xxxxxxxxxxxxx 
xxxxxxxxxxxxx 
xxxxxxxxxxxxx 

— ™\ ? f ♦ 



'•LINE*' 



/ \ 

I x I 

\ / 



\ / 
\ / 

I, 

\ / 



J ••OUT** 



/ V 

/ V 

/ V 



4.« 4....«. ♦ 

« ■ 

« • 

t xxxxxxxxx }-♦ 



••TABLE" 

TABLE 

xxxxxxxxxxxxx 
xxxxxxxxxxxxx 

xxxxxxxxxxxxx 

.• - — ^—4. -. — -.— . 
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4.0 DOCUMENT FORMATTING SYSTEM 
4.6 DIAGRAM - DIAGRAM DRAWING AID 



I "CUBE*" 

/ I I 

xxxxxxxxx 
xxxxxxxxx 
xxxxxxxxx 



To use DIAGRAM you call up the SES DIASRAM procedure with the 
following paraiReters : 



name of the file to receive the Jutput from DIAGRAM. This 
parameter Is required. 



The next three parameters are Introduced by the keywords cl and 
c2 and c3» They represent a list of shapes that are to be placed In 
column one* column two and column three of the page gridf 
respectively. For example* the grid of shapes given above was 
generated by the following SES call s 



ses«diagraiii o«anyfile* cl«Cbiank#conn#out9Ciibe)» ••^•* 
c2«(box9 ln*stack)» c3s<cond» t i net tab I el 



where anyfile is the output file used for the exaitple. The shape 
"najiies" were added by editing the output file. It Is usual to 
Include diagrams in your file in "asls" mode. 
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4*7 MEMO - GENERATE STAMDARD MEMO HEADER 



4 . 7 i£ii3^=:«Mli£EAI£-.SIiimMfi«ll£iQ-.U£M£E 

MEMO places a standard TXTCOOE format banner at tfie front of a 
file containing the text of a memo. Oate^ 'to«» »ffom« and subject 
information can be entered as parameters ta 1EM0. Internal to the 
resultant file* the TXTCOOE table direct! yes are set up such that 
further recipients* names laay be added easily* Parameters to MEMO 
are as fol I ows ? 



I or f : 

naiae of Input £ile containing the text of your niefBO* to 
which the standard header Is to be tddsd» 



o : 



to J 



fron 5 



(optionaU name of the file to receive the Qutput of MEMO. 
If you don't code the o parameter* MEMO places the output 
on the file specified by the I paraieter. 



{optional) naiae and location of the person to whom the memo 
is to go* It is coded as a list? the first item In the 
list is the recipient's name and the second Item is the 
I ocati on • 



(optional) name and location 3f the person sending the 
memo. It is coded similar to the to paraneter. 



when : 

(optional) date to be placed on the nemo.f If you don't 
code the wtien parameter* MEMO uses today's date as a 
def aui t* 



s or subject : 

(optional) string which is the subject line to be placed in 

the memo* 



Some of the parameters above can get default information from 
your profiief as follows : 

faccode is the £l£.ility CQC£ variable* The value of faccode are 
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4,7 MEMO - GENERATE STANDARD HEHO HEADER 



used botN for the to and from location If they aren't 
specified as parameters* 

lynaiiie is the profile variable containln?i your name^ which Is also 
used by the trial I facilities* If you don't code the first 
element of the fro» parameter Mstf I1E?10 uses the fnynane 
profile variable* 



By this tiflne you should be suitably confused by this explanation 
so an example Is In order J 



ses*iReiiio l«anyflie» to»f 'Ethel Snerge'^ londonlf •«*^*^4 
frofi«C' Stanislaus Bonokowonokoni tch*» par1$9t«*^*< 
subject^'hunting the snark' 

REVERT* END MEMO AHYEILE 



The result of this would be a standarrl ^eno header at the start 
of anyfiie as shown on the next page 5 
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4.7 H6H0 - GENERATE STANDARD MEMO HEADER 
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H 
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n 
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EEEEEEE 
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H 



M 



nn 
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N 
H 

n 



aoooo 

Q 



00000 



\para 

Xsety* 

Xseth"" 

\setbd 

XblankOlO 

\slclp4 

\asis 

\bold 

C 
D 
C 

\nobold 

\tabteM#45 

\sKip4 

5''*'^DATE*i 
\skipl 
\tabien#45 

\tabie;llf56 

Xsklpl 

\tablen#45 

J**''*'FROH''s '"STANISLAUS B0N0K0W0N0K0WITCHJ13CATI0H'':'*PARIS 
\tableillf56 
\sklp2 
\tabten#45 

JSUBJECT"" J ''-HUNTING THE SHARK" 
\block 
\sklp4 



14* 1979 



SNERG€jiaCATIQN''s *LONOOM 
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4.8 TXTCOOE - RUN TXTCODE OOCUHENT PREPROCESSOR 

TXTCOOE is a high level preprocessor for TXTFQR^. This procedure 
runs TXTCOOE in a stand alone fashion. It i^ay be used as a building 
block for larger procedures to forffl a coispfete document formatting 
systeia. Parafneters to TXTCOOE are : 



i or f : 



o : 



e 5 



name of Input File containing source text to be processed 
by TXTCOOE. 



(optional) name of fife to receive the Output from 
TXTCODE. If you don't code the o para?neterf the output 
appears on the file specified by the I parameter. 



(optional) name of file to receive the Error output from 
TXTCOOE. If you don«t code the e parameterf TXTCOOE 
doesn't produce any error file. 



Example of TXTCODE linage 

ses.txtcode codeln codeout errlist 

REVERT. END TXTCOOE COOEIN > CQDEflJT* ERRLIST 

This example shows TXTCODE used to process the data contained in 
file codeln* and produce the TXTFORH source on file codeout. Any 
errors go to file errlist. 
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4.9 TXTFQRM - RUN TXTFORM DOCUMENT PROCESSOR 



4 . 9 I]LimEll.=-Eyii.IlI£QEi.Efi£yM£MI-£SQ££ii2i 

TXTFORH is the isaln component of the docawent prbcessJnci system. 
This procedure runs TXTFQRM stand alofie. It can foe used as a 
building block for larger procedures to f6rm a complete document 
foriaatting systefR* Parameters to TXTFORH are « 



I or f : 

name of Input File containing source text to be processed 
by TXTFORM. 



o 1 

{optional) name of file to r*eceiy« the Output from 
TXTFORM. If you don*t code the o parafneter* the output 
appears on the file specified by the I pir^^meter. 



Example of TXTFORH Usage 



ses.txtforn i«foriiiinp# o«foniiout 

REVERT, END TXTFORH FORHINP -> FOR»IOIIT 
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4.10 TXTHEAO - PAGE HEADING PROCESSOR 



TXTHEAD is a postprocessor for TXTE0R1. TXTNEAD Is used to 
change the format of the heading banners on docifient pagesf where 
the standard heading format is inaporbpr I at e. There is 
documentation on TXTHEAD in and appendix to this User Handbook. 

This TXTHEAD procedure runs TXTHEAD in a stared alone fashion. It 
may be used as a building block for larger orbcediires or jobs to 
form a complete docuinent formatting systefs. Parameters to TXTHEAD 
are 5 



lor f 5 



nafpe of Input File containing TXT^OR^ output which Is to 
be processed by TXTHEAD. 



(optional) name of file to recel/e the Output from 
TXTHEAD. If you don't code the o oar'amst er» the output 
appears on the file specified by the I parameter. 



Example of TXTHEAD Usage 

ses«txthead i»foriioyt# o«headoyt 

REVERT. END TXTHEAD FORMQUT -> HEADOIIT 

This example shows TXTHEAD being used to process the output of 
TXTFORH contained on the file fornoutf and produce the output file 
headout. 
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4*11 S£ME£Mfi.=.^iMI£AI£-SMIiiiQM-M£i^£a£-^12IIlJaEMIi: 

GENREVB is a procedure that works in conjunction with TXTFORH^ to 

format a docuroent with bars down the right hand side of the page to 

show changes froiB a previous document. GE^IREVB functions by 

comparing the source text of two documents %n4 generating a set of 
special directives to TXTFORM* Parameters to GENREVS are s 



i or f or new 5 

naflse of File containing the NEW version of the docu^aent In 
TXTFORM source format. 



b or old i 

naiae of file containing the QL5 Cor Basel version of the 
document in TXTFORH source format* 



ioptlonai) name of file to receive the Output from 
GENREVB* If you don^t code the o parameterf the output 
appears on the file specified by the I parameter* 



neMcset 



(optional) designator for the NEif fife's Character SET* 
The table below describes the allowed designators* 



oldcset : 

(optionall designator for the 31D file's Character SET. 
The table below describes the allowed designators* 



outcset I 

(optional) designator for the OiTput^lle's Character SET. 
The table below describes the allowed designators. 



Is or ignorls t 

these (optional) Isfiis specify whether or not to IfiMQRe 
Leading Spaces on lines being compared. The default action 
Is to recognize leading spaces (the Is option). If you 
code the ignorls ^&t» GENREVB Ignores leading spaces on 
text I ines. 
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4,11 GENREV8 - GENERATE REVISION BARS FOR D3CUHENTS 



The default character set designator for all three cset 
parameters is £1^12* The following table defines the aHot#ed 
designators for the cset i>arameters i 



i2£si^iiiisi: 



CS612 



NOS 6/12 ASCII character set 



cs64 



64 character ASCII subset (display code) * 
character set J 



csai2 



"8 out of 12" ASCII character set 



Exafliple of GENREVB Usage 



ses.genrevb isnewtext^ b«oidtext> o«changes 

REVERT. END GENREVB NEMTEXT « OIDTIXT •> CHANGES 

This example shOMS GENREVB used to compare the two document 
source files neiitext and oldtext* and produce the change directives 
in the text on file changes 
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4.12 GENREVP - GENERATE A REVISION PACKAGE FOR A DOCUMENT 

GENREVP bulicis a revision package by comparing the outpyt of two 
formatted docuipents. Parameters to GENREVP' ^rs s 



neu or newdoc t 

name of NEW OOCyiaent to be processed by GENREVP. 

old or oiddoc < 

name of 010 OOCuaent to be processed by GENREVP. 

hoM or hOHfile : 

is Coptionall and specifies HOW the processing is to be 
per forroedf tbat isf which lines nre ta be Ignored for the 
purposes of the comparison (date* tiite and such). The how 
parameter is ^lili^t the nawe of a fife containing the 
direct! ves# Qt, it's a list of character strings on the 
control card Khich specify the directives. If you don't 
code the how parametert GENREVP attempts to use the file 
naroe associated with PROFILE variable myhowf. If there 
isn't such a variable in your prafife* GENREVP uses a 
standard set of directives suitable for the standard 
output of FORMAT. 

I or listing t 

(optional) naiae of file to receive the listing of the 
selected pages after the comparison. If you don't code 
the I parameter* GENREVP uses file listing. 

s or suamary : 

(optional) name of file to receive the summary of the 
changes* and a "how to update the document" description. 
If you don't code the s parameter* GENREVP uses file 
summary. 

or output : 

(optional) name of file to receive the OUTPUT of GENREVP. 
The output file contains error i»essages and statistics. 
If you don't code the o parameter* GENiPEVP attempts to use 
PROFILE variable output* and If such a variable doesn't 
exist* file output is used. 



folio 



this (optional) jsji indicates that the F3LI0 line of the 
documents is not to be compared for' the purposes of 
generating the revision package. 
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4.12 GENREVP - GENERATE A REVISION PACKAGE POR A DOCUMENT 



MiaiIE-ii£satii§i 



Directives to GENREVP Cspecified via the how 
the foHowjng form <one per line) s 



parameter I are of 



L1..L2 CI.. 02 



coanents 



11. .12 specifies a range of lines (if you only -lant to indicate a 
single line* the *.L2 can be omlttedl and if you iiant to indicate 
all lines f use an *>5 and C1..C2 specifies a range of columns (if 
you only nant to indicate a single coiuian» the .I.C2 can be osiittedj 
you want to indicate all columns* use an ♦ ) • Any comments 
a directive line are ignored. The directives are used to 
ithat parts of what lines are to be ignored when 
of formatted docusients for differences. 



and if 

present on 
tell GENREVP 
comparing pages 



standard set of directives is t 



The 



2 

3.. 4 
* 

60 


60. .79 
60. .79 

80. .136 
* 


The last 


directive 


given. 





page number 
date 

formatting codes 
fol 10 1 Ine 



Cju^k) 



Is generated only If the folio parameter Is 



Examples of GENREVP Usage 



ses.genrevp thisdoc» thatdoc» folio 

REVERT. END GENREVP THISDOCt THATDOC — > LISTING#SUMMARY 

This example of GENREVP compares the two document listings 
thisdoc and thatdoc to generate a listlig of the changed pages on 
the file listing* and a summary of the changes on the file sunmary. 
The folio ]s£i indicates that the folio line Is also to be ignored. 
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4,0 DOCUMENT FORMATTING SYSTEM 

4*12 SENREVP - GENERATE A REVISION PACKAGE FOR A DOCUMENT 

ses«gefirevp gfab# hoi d# hoii«{«3*«4 60*i«f9«f »* 80»«999») foHo 
REVERT. END GENREVP GRABfHOLD — > LlSTtSG, SUMMARY 

This exampie shOHS the how parafseter of GENREVP used to Indicate 
that character positions 60 through 79 on fines 3 through 4 are to 
be ignored for the purposes of coiaparis^nt and that character 
positions 80 through 999 on all (♦) lines are to be ignored. In 
addition* the folio |S5^ indicates that the folio fine is also to be 
i gnored. 
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SES provides a comprehensive set of proceciures to manege source 
text libraries. The source text maintenance package of SES is based 
on a special version of the NOS utility HODIFY called HAOIFY. 
MADIFY differs froai tlie standard version In that It caters to the 
NOS 6/12 character set; and It supports asilgi and £flj3illtiaaji calls 
to co(B8ion decks Csee the description of the SEHCQHP procedure for 
details on the CALL directives available t3 the ^ADIFY user). 

It's assumed that If you're using these source text jnai ntenance 
procedures* that you're moderately faslliar with the concepts of 
HODIFY* including things such as decks* coi'woi decks* correction 
idents and so on. Before giving a short stiiiuarV of the source text 
maintenance procedures* *ie'll introduce some of the terminology that 
SES uses. 



BASE Is a library of source text.i AH the source text 

maintenance procedures use a default nnme of 8ASE. You can 
establish a default base In your profile by coding 

\ base « •whatever.yourlbase^'ls* 

NODULE is a single record of source text on a base. A module may 
be a COHHON module (COM or C or O^LO* or a module may be a 
REGULAR module (REG or R or QPL) 



GROUP Is a file containing text In the form of MODIFY '•source*' 

records. Ih^i i5x ^^fill IfliliiiJi tS^Sti i'Q th^ fill hlS. its 

Qji£ js thSL ILt^t iins 2t ih& Lssat^i and it th& tissiil is 
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GETMODCSI GET MOOuleS ayi at a base tibrary aata a group file* The 
modules appear on the groyp file in HOOIFY "source" 
format as one module per logical record*" 

REPHOOISJ REPIace or add MOOuleS on a base library. You also use 
REPMODCSI in a special way to create a brand nem base 
library from scratch. 

COLLECT collect a group of modules and accuiiulate them on a group 

file. 



GENCOMP GENerate a COMPIIe file for a iiodule or a list of 

isodules. 



G£NCOR(S) GENerate a CORrectlon Set for a nodule. 



TEHPCOR Make TEHPorary CQRrections to a base without actually 
creating a ne*« base. 

MODIFY MODIFY a base library with a correction set file creating 
a new base I i brary • 

CATBASE CATalogs a BASE library to produce a short list of the 

names and types of modules contained In a base library. 

LISTMOD LIST MODules. LISTMOD generates a cross reference 

listing of all the modules on a base (using the XREFMOD 
procedure described beloM}^ and optionally a source 

listing of all the modules or all the common modules on 
the base. 



SORTMOD SORT a MODify library. Modules apoear on the sorted base 
in alphabetical order by deck natie (the deck type is not 
used in the sort process). 



WIPEMQO 



WIPE (delete) MODules from a base. 
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XREFHOO Produces a cross (X) REFerence of I130u1%s In a source 

library* For each laodule is listed the modules It calls 
(directly or indirectly) and the rnodules that call it 
Cdirectly or indirectly). The tISTHOO procedure* 

described above* can be used to run XREFHOO as a batch 
job. 

GETCOHN ACQUIRES the CYBCCHN or CYSICHf^ common deck program 

library* in the HADIFY or SCU ^orm* ^n^ snakes it local to 
your control point* 

SYSTEHX a HAOIFY based CY8II system cross reference facility* 

SCOOP Compares HADIFY or UPDATE source files* 
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«sa«« 



REG 
C regular 
nodules) 



4" 



COLtECT 



5 ♦ 



ss««S3ixssa«««s« 



COH 
— (comnon 
modules) 






GROUP 
(accumulated 
modul es) 



/ S / 

: 6ETNoo(S) : 
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i modules) •/ 
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modules) 
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CQRS 
(correction 
sets) 
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/ V / 

: MODIFY S 

♦— ^>5 (update I 

* base) 1/ 
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BASE 



NEW BASE 
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file) 
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This section introduces the parameter Tailing convention common to 
most of the procedures in the source text maintenance system. 

b or I name of Base Library on vihlch the operations are to 

be performed. 

c or COB oropic fist of naraeCs) of COHmon lodul eCs I • 

r or reg or opi list of nameCsJ of REGul ar* loduf et s I . 

iR stands for Module{s)# and Is used in those 

applications where the itodule naies do not have to 
be expilcitiy specified as cofnmon or regular* 

g or group name of file upon which a GROUP of (iiodules are 

accuffiulated when adding ar replacing modules on a 
base* or when modules are extracted from a base* A 
group file contains one locJule per logical record* 
and ffiay be edited using procedure HULTEOf and also 
may be processed by procedures PACK and UNPACK. 

cors or c name of CORection Setts) to be applied against a 

base for maintaining correction histories. 

nb or nl name of a New Base or New Library* used in those 

procedures that perform ooeratlons that permanently 
alter a base* requiring that a new base be created* 
An explanation of the method used to update a base 
is contained in a subsequent section. 
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The var i afales descr Ibed b€lo» way be declared In your I>ROI=^IL£ in 
order to establlsii default Information for ths parameters of the 
source text maintenance procedures* 

base name of base library where modules are to be found or 

replaced* 

baseown user na«ie In whose catalog the base is to be found. 

nevtbase name of nen base library for those procedures **hlch update 
a base I ibrary# thereby creating a new oie* The default 
name for newbase is the same name as the old base* 



cors used by aM procedures as r^ane of file containing 

CORrection Sets to be applied to a base. The default name 
for this file Is cors* 



group used by all procedures to designate a group file* or a file 

containing modules in source foriat> one nodule per logical 
record* The default name for group is group* 

cfseq used by GENCQMP to Indicate whether to place sequence 

numbers on the compile file* If vou wish to use this* 
declare It as seq* 

cfuidth used by 6ENCQHP to specify the iiidth of the compile file* 
The default value for this is 110*? 



sestnpb used by all of the procedures that update bases to specify 
the temporary base fife during the update process* The 
default name for this file Is sestnpb* 

lokiRode used by all of the procedures that update bases* to 
determine the default interlock action*- Ibkniode may be set 
to one of «LQCK' or •NOIQCK'* See also the sections below 
on updating bases and Interlocking* 
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ifitriok used by aM of the procedures that update bases or 
libraries to specify the interlock fl I e to be used during 
the update process. The default rianie for this file Is 
intrlok* 
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Some of the source text maintenance procedures Physically alter a 
base» requiring that a new base be created* the process is cominon 
to all such procedures* and is as follo*«s : 

If you code both the b and nb parameterst the naw base Is created 
simply by performing the required operations on the old base> and 
writing the newly created base onto the fife soeclfied by the nb 
par arneter • 

If you code only the b parameter* the update takes place in two 
stages* The updating operation is performed af^d the new base 
written to a fife called sestnpb ISES Temporary Base)* sestupb Is 
then physically copied back over the fll^e specified by the b 
parameter* and finally sestapb is purged. 

Note that if the file specified by the nb Cor b if nb Is omitted) 
does not already exist* a DIRECT access REAl mode file is OEFINEd 
for the base fthis* of course* can only be done if the owner of the 
base is the current user)* 

Note that if anything goes wrong during an updating run* the 
original base is always left intact* and only the new base or 
sestnipb is potentially incorrect* This means that you can recover 
by purging the new base or sestmpb and starting the run again* If 
something goes wrong hS.tQ,L& the base appears on sestmpb* the 
original base is intact* and sestmpb nay be purged* whereas If 
something goes wrong Mtt&L the new base is on sestmpb* that Is* 
during the *«rewrite" phase of the update* It is sestnipb that is 
safe* and the old base that is wrong. In this case* you may use the 
REWRITE procedure to do the rewrite again* or' al tern at Ively* you may 
just purge the old base* then change the na^e of sestmpb to be the 
base name. 
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When updating a b%se or library you can Ir^ter'fock the update so 
that only one user at a tlr^e can update the base or* library* Those 
procedures that update a base or library are set up so that If the 
base or library to be updated is in another* jser**s catalog* the base 
or library Is interlocked by default* You can override default 
actions by defining a loknode variable in your prof I I e# or by coding 
a lock or nolock jifii on the procedure* as show^i in the dlagraoi on 
the next page* 

Interlocking of a base or library is doie via an interlock file* 
Such a file lysi he a MB££I access file i¥ tl32 SJi§ ilSStiS fiJiaiaa 
MS. llast kMiM 2L iil2£.m i2£iQ^ iiadJtSil* Naturally the interlock file 
must be a FUBLICt WRITE MODE file if other* users are likely to be 
using It* The default name used by the SES source code maintenance 
and library laanagement procedures for the lock file Is Intrlok* You 
can have an interlock file of any nane by def i ning the Ifitrtok 
profile varlabief or by coding a file name as a value for the lock 
parameter on the appropriate procedures* 
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Afiiiaa laksQ 



iock 



library or base is locked rega 
iokmode profile variable or ot 



fdless of contents of 
kBT' corid 1 1 Ions* 



no lock 



library or base is Hai locked 
of tokaode profile variable or 



regardless of contents 
other condi t Ions. 



l^aiiSiQiS 



£fij£ii is ItQlilS, t 



4Stli2ll iMk&Q 



\ lokfROde»*i.0CK« 



I I Ibr ary 
1 unless 
I parameter 



or base is locked 
overbidden by no lock 
on procedure. 



\ lokfliode««HOLOCK« ! library o 

* unless 

• parameter 



r base is aal locked 
overridden by lock 
on procedure. 



iii2iiliBi2 



Ql LihLMt:i 



Current User 



Another User 



iQtian IjKsq 



library or' base is flfli 
locked unless the lokmode 
prof He var I able Is set 
to •LOCK* or the lock 
parameter Is coded on the 
procedure.? 



library or base is locked 
unless the lokmode 

oro^ile variable is set 
to •NOLaC<* or the nolock 
oa'^aifleter Is coded on the 
orocedur e 



♦- ' 
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5.1 GETMOD OR GETHODS - EXTRACT HODUIE GROUP ?=ROH BASE 

5 . 1 fi£IllQfi«Q£.S£IliQSS«~-.£lIE4£I-.!iOliyJL£.£EQil -lEaLlili 

GETHOO and GETHODS are synonyms for a orocelure designed to 
extract a designated group of modul es (or all iiodules) froa a MAOIFY 
library* and place the extracted modules or\ 3 'iAOI^^Y *»source*« format 
filCf that i Sf each extracted isodu I e occiiples one logical record on 
the "source** file. Parameters to GETMOOCSI are s 



m or al I : 

Coding the all Ml&X indicates that ALL modules are to be 
extracted from the specified base.? Tfie 1 parameter refers 
to a module or list of modules to be extracted. Ranges of 
modules may also be specified* 



g or group : 

(optional) name of file to receive the modules extracted 
from the base* If you don't code the g parameter* 
GETHOOCS) uses the value of profile variable group as the 
group file name* and if there's to such variable defined* 
GETHOO(S) uses the name group as the name of the group 
file* See the note on GROUP filas at the beginning of 
this section* 



b or I : 



(optional) name of Base Library from v#hlch modules are to 
be extracted* If you don't code the b parameter* 
GETHODCS) uses the value of praflle variable base as the 
name of the base library* and if there's no such variable 
defined* GETMOOiS) uses the name base* 



un 



(optional) User Name In whose catalog the base specified 
by b is to be found* if b is not In the catalog of the 
current user* If you don't code the un parameter* 
GETflOO(S) uses the value of profile variable baseotin as 
the user name from whose catalog the base is to be 
obtained* and if there's no such variable defined* 
GETMOD(S) uses the current user's catalog* 

cors or c 2 

(optional) is a file containing a CORrection Set to be 
applied against the base b before the module m is 
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extracted* If you code this parameter* SES procedure 
TEMPCOR Is iised to apply a TENPorary CQRrection set. Note 
that TEMPCOR doesn't actually alter the base* the 
correction set Is only applied for the duration of the 
GETMODCSI run. 



w or width i 

(optjonail BiaxJffluiR Width of isodijl^s retrieved* 



status or sts : 

these (optlonaM Isi^i can be used for those cases where 
GETMODCS) is being used bs a building block of more 
sophisticated procedures or Jobs* The status iiaxs cause 
GETNQOCS) to set the NOS job c3?itrof register EFG to the 
value zero If GETMOD(S) successfully completed* and to non 
zero If anything went wrong darln(| the run of GETHODCS)* 
If status Is not specif led* the arocedure will EXIT If an 
error occurs* 



iiisg or noiRsg : 

these {optional} ii£is contrbl the generation of 
Informative messages by this procedure and are fully 
described in the section entitled "INFORMATIVE MESSAGES 
FROM SES PROCEDURES"* 



Examples of GETMOOCS} J^age 

ses«getmods (outtind# liBiitsd««oprtypk# ststypk^ synientd«*syflik) 
REVERT* END GETMODS GROUP <- BASE 

This example shows GETMOOS used to extract n bunch of modules from a 
base* Modules outlind* all modules lliiitsd through oprtypk* module 
ststypkf and all modules symentd through syik are extracted* Every 
parameter to GETMODS is set to its def au I t val ue* The modules 
appear on the file group* 
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ses«getmods ail b*cidbase un«dt73 g«iufik 
REVERT. END SETHODS 4UMK <- CI08ASE 

This example extracts ALL modules frofls base cidbase In the catalog 
of user dt73 onto a Qroap file Junk 

tints, 5 A possible method of using this arbcedure is to extract a 
group of modules using GETHQOS* to edit those modules using NULTEOf 
and finally to replace the modules in the base library using REPMOO. 
For exaiRpI e : 

ses.getfliods all b«cidbase| nylted; repmods b»cidbase 

The example gets all modules from base cidbase*: uses procedure 
MULTEO to edit the group file (MULTED«s default Input file name Is 
gr6yp)# then replaces all the modules on cidbase again. 
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5.1 SETMOD OR SETHODS « EXTRACT HOOUiE SRlilP FRQ!i 



BiSE 



l^aii.£l£M.aI.i2£lJ!30l2iil.u;iJii£ 



x-c s « 3 s at s « s 



BASE -^ ^ >J OETHODISI I- 



tmMmM-M9Mm> 



MmmmmM mm mmmmmm m 



t modulesl If 



GROUP 
•Xextracted 
moduf «sl 

mmmmmmmmmmmm'. 






.-«4. 



mmm mmmmmm mmmmmm 

CORS 
Ccorrect ion - 
s e t s ) 
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GETMOO<SI Is a fairly simple process ? a fist of modules Is 
extracted from the base library* and appear on file group in MADIFY 
source fori»> that Is* one module per logical recorlf. An optional 
correction set (the cors parameter) may be applied temporarily to 
the base before the ]»oduies are extracted. Procedure TEMPCOR 
applies the temporary correction sets* 
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5«2 REPMOD OR REI>MQOS - ADD OR REPLACE MODJliS 

REPHOD and REPMOOS are synonyias for a procadura for adding or 
replacing moduleCs) on a base* Parameters to REPHOOCS) are J 



fli : 



{optional) list of Nodules to ba added to or replaced on 
the base. If you don't code the m- paranneter* REPHODCS) 
assujpes that the moduleCs) to bs added or replaced are on 
the group file specified by the g parameter. Note that 
each file specified by the m parameter is treated as a 
HADIFY source file (or '•group" file) viith exactly aas 
module on it* See the note on GROtiP files at the 
beginning of this section. 



g or group i 

(optional) narae of the group file to be used to accumulate 
the modules. If you don't code the g oaraweterj REPMOO(S) 
uses the value of profile variable group as the group file 
name* and if there's no such variable defined* REPMOD(S) 
uses the name group for the group fife. See the note on 
GROUP files at the beginning of this section. 



b or i 



(optional) name of Base Library to be updated. If you 
don't code the b parameter* REP'IODtS) uses the value of 
profile variable base as the name of the base library* and 
if there's no such variable defined* REPMODCS) uses the 
name base. 



nb or nl : 

(optional) name of the New 8ase to receive the updated 
library. If you don't code the nb parameter* REPMOD(S) 
uses the value of profile variable neifbase as the name of 
the ne*i base library* and If there's no such variable 
defined* REPMOD(S) uses the na^ne of the base library 
specified by the b parameter. 



un 



(optional) User Name in vihose catalog the base specified 
by b/nb is to be found* If b/nb Is not in the catalog of 
the current user. If you don't code the un parameter* 
REPIIQD(S) uses the value of or'oflfa variable baseoMn as 
the user name from whose catalog the base is to be 
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obtained^ and If there's no sticti variable defined* 
REPHOOiS) uses the current user's catalog. 



11 or Hldth or intiidth : 

(optional} aiaxlmum Width of the Ifiput nnodules. 



lock or no lock : 

these (optional) parameters detemifie whether the base 
update process Is interlocked against simultaneous updates? 
coding a filename for the lock parameter determines the 
nan?e of the interlock file. Interlocking Is the jlfiflMit 
action when the base being updated Is In another user's 
catalog* If you don't code either of the lock or nolock 
liSXS.^ interlocking is controlled by the lokmode profile 
variable. Refer to the Introductory sections of this 
chapter for Information on the Interactions of the lokoiode 
profile variable and the lock and nolock parameters. If 
you don't code a filename for the lock parameter* the 
contents of profile variable Intrfok Is used as the 
interlock filename; if there's io such profile variable* 
the name Intriok is used as the lock filename. The 
interlock file lusi be in the saiie catalog as the base 
being updated. If the interlock file cannot be found* the 
procedure aborts* 



batch Job parameters s 

These parameters are described in the section entitled 
"SES PROCEDURES RUN AS BATCH aasS". The default for this 
procedure is to run In local node* but It can be run in 
batch mode. The dayflle parameter Is not used by this 
procedure. 



msg or nomsg s 

these (optional) lifi3t§. control the generation of 
informative messages by this »rocedure and are fully 
described in the section entitled "INFORMATIVE MESSAGES 
FROM SES PROCEDURES". 
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Exawples of REPHQDIS) Usage 

ses«repfflod (hertZf maxifelif diarconl)* b«fadllo» nomsg 
REVERT. END REPHQO GROUP -> RADIO 

This exafflpie shows three jnodules being callacted onto a group 
file group <the defautt)^ replaced on the base called radio. Since 
the noiiisg |S£X «s coded# no informative juessacies are output during 
the run of REPHOD. 



ses.repniods Cgrab» tioldl b«zilch g»teinp vf«89 lock nsg 

* GRAB -> TEMP 

* HOLD -> TEHP 

* LOCKING ZILCH VIA INTRLQK 

* ZILCH LOCKED 

* REPLACIM6/A00ING HOOULES OH ZILCH 

* MEW BASE ON SESTMPB 

* NEW BASE NOW ON ZILCH 

* SESTHP8 PURGEO 

* BASE ZILCH UNLOCKED 

REVERT. END REPMQDS TEHP -> ZILCH 

This example shows two modules being replaced on the base zUch 
through a group file temp. The width of the Input lines Is limited 
to 80 (ASCII) characters (because of the w par aineter ) . Because the 
lock liax was coded> the base Is locked during the run using file 
intrlok (the default}. Informative messages are output during the 
REPMQDS run because the nsg li£i was coded. 



5-18 
COC - SQFTJIARE ENGINEERING SERVICES 

18 December 84 
SES User's Handbook REV? 4A 

5.0 SOURCE TEXT MAINTENANCE 

5«E REPMOD OR REPHQDS - ADO OR REPLACE HCIDIJLES 

If you are creating a brand new base fron scratch* you use 
REPMODCS) slightly differently from the nor^ntl caset in that you 
code a b Cbasel parameter jail an nb {new base) oarasnetert but the b 
parameter refers to a non existent base* as in this example s 

ses«repmods lyorl<»htint) b«nonsych nb'fienstiif 

♦ rORK -> GROUP 

♦ HUNT -> GROUP 

♦ CREATING NEW BASE NEWSTUF 

♦ NEW BASE ON HEMSTUF 

REVERT, END REPNODS GROUP -> HEWSTIJF 
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5.2 REPHOD OR REPHOOS - ADD OR REPLACE MODULES 



Mia«£ifiM-ii£«S££iQfiiil-££iiS5i5LA 



GROUP 
Cfile of 
nodulesi 

MMMmmMmm at mmm-afmm 
I 



REPNQOCS) S- 






•™— >• (replace 



5 ♦ 
J/ 



KB 
'>fneii base) 

3 ««««« «««««'«««« 



B 
or iginal 
base 

tmammmMMmmMMm 



REPMODCS) takes modules front a group file ft^hlcN* as shown in the 
diagraffl* could well have come from the old base In the first place)» 
and replaces (or adds) them to produce either a coiipletely new base* 
or rewrites the result over the old base. 
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COLLECT Is useful in conjunction with source text maintenance 
procedures such as REPMQOCS). COLLECT builds a group file by 
COLLECTIng i^odules of a specified type* adding in tbe module nai»e 
and COMMON lines* and copying the modules to a §roup file* Also* 
COLLECT can accumulate members of different types onto the group 
file* and so may be used In conjunction with the library management 
procedures described in another section. Parameters to COLLECT 
are s 

m or mem or mens or neaber or nembers s 

(optlonaH list of Members to be accumulated onto the 
group file* When used in conjunction with other Source 
Code Maintenance procedures* COLLECT assumes that files 
specified with the m parameter already have the deck name 
as the first line of the file (and COMMON as the second 
line for a common deck). Hail ' I ** the file specified by 
the m parameter Is a multi record file* COLLECT liass 
gather all records in the file. This capability is aai 
available with the c and r parameters as It is not truly 
applicable in those cases. 

c or com or opic J 

(optional) list of COHmon modules to be accumulated onto 
the group file. COLLECT assuiies that such modules are 
straight text files* and so COLLECT pi aces the module name 
and COMMON lines at the start of the nodule. 

r or teg or opi s 

(optional) list of REGul ar modules to be accumulated onto 
the group file. COLLECT assumes that such modules are 
straight text files* and so COLLECT places the module name 
line at the start of the module. 



g or group : 

(optional) name of group file onto which the member(s) or 
fflodule(s) are to be accumulated.! If you don't code the g 
parameter* COLLECT uses the value of profile variable 
group* and if there's no such variable defined in your 
profile* COLLECT uses the f 1 1 enane group. 



msg or nomsg : 

these (optional) k&XS. control the generation of 



CDC - SOFTWARE ENGINEERING SERVIC€S 
SES User's Handbook 



5-21 

18 Dece^iber 84 
REVS 4A 



5.0 SOURCE TEXT HAINTENANCE 

5/3 COLLECT - COLLECT HODULECS) TO BUILD A GROUP FILE 



Informative aessages by this arocedure and are fulty 
described in the section entitled "INFORMATIVE MESSAGES 
FRQH SES PROCEOURES**, 



Examples of COLLECT Usage 



sesscollect c'fcdCf ici» ibmlf rs(sdCf ifs» cscl» g«acronyiii 






CDC/COW 
ICL/CQH 
I8H/C0H 
SOC/REG 
IFS/REG 
CSC/REG 



-> 
-> 
-> 
-> 



REVERT. 



ENO 



ACRONYM 
ACRONYM 
ACRONYM 
ACRONYM 
ACRONYM 
ACRONYM 
COLLECT 



ACRONYM 



This example shows six straight text files being collected onto a 
group file acronym* The first three are specified as common modules 
Cthe c paraffleter)> so COLLECT adds the module name and COMMON lines 
at the front of the file before adding it to the group file. The 
last three are specified as regular modules Iths r* par ameter )# so 
COLLECT adds the inodule name line at the start of each one before 
adding it to the group file* 
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5.3 COLLECT - COLLECT MOOULECS) TO SUILD ^ SR3JP FILE 



OjiJ.£l&ii.aI.COLL££I.a£a££SEiaa 



R fflf REG or OPL 
regutar — — 
iRodyl es 






C CCOH or OPLCI 
•—•"• coisnon 
Modyl es 



4.«.. 4..4.... >..4, 


/ V V /I 


4>««.«»»«.«.«.««.««.4. • 


! COLLECT \ X 


\ (make a 1 ^ 


• group) M 


4.«— —4 -.—-4 


1 


« 
• 


V 


««««««««««««««» 


G or GROUP 


file containing 


modules 





As shown in the diagram^ COLLECT takes files designated as either 
reguiar or common jnodulesf and gathers them onto a group file* 
COLLECT can also Just gather up records which already have header 
Information in them (the m parameter)* 
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5 . 4 ii£li{lii£^.S£liIEiIf ^CaE£iL£-£iL£-£(li.!iaailLIiil 



SENCOHP generates a compile fife for a ^nodule or a group of 
fflodules. Only regular fBodules can be SENCOHPed. The GENCQHP 
process resolves calls to coraunon niodules Cii^cludf^g BfiSiSil calls) 
according to the folloviing ••coaipMe file" directives s 



*CAtL module 

This directive unconditionally calls 
module* 



the specified common 



*CAtLC Module 

This directive only calls the specified cofiimon module If 
it has not already been called vfi thin the current regular 
module. The Information about which comnon modules have 
been called is cleared at the en^ of processing each 
regular module* 



♦IFCALi name module 

This directive only calls the specified common 
the specified name has been defined {see 
parameter described below)* 

♦NIFCALL name module 

This directive only calls the specified common 
the specified name has not been defined (see 
parameter described below)* 



module If 
the define 



modut e if 
the define 



GENCQMP permits the specification of a list of alternate bases 
from which to resolve common deck calls (or in which to find modules 
to be GENCOHPed)* Also* a source file nay be specified which 
contains source for modules (or common nodules) to be used in the 
GENCQMP process* In addition* correction sets may be applied prior 
to the compile file being generated* 

When generating the compile file* M45IFY searches for decks in 
the following order J 

If the SF parameter is coded* the specified file Is searched* 

- If the AS parameter Is coded* the soscified files are searched 
from right to left* 

- If the CYBCCMN or CY8ICMN parameter is coded* the designated 
common deck base is searched* 

- Finally* the base specified by the B para'seter is searched* 

Parameters to GENCOMP are J 
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m or al i i 

This {optionaU parameter specifies a list of modules 
C including ranges of modules) for which the compile file 
is to be generated* If the all Ig^ Js coded* a compile 
file for All of the < regular) lodiiles in the specified 
basets) are produced* If you doi't code the m parameter 
at all* you fliust code the sf parameter {see below)* 



cf 



b or I 



un 



(optional) name of the Compile Fife to be generated* If 
you don't code the cf parameter* GEMCOMP writes the 
coffipile file to a file called cofiplle*! 



(optional) name of Base Library from which to generate the 
compile file* If you don't code the b parameter* GENCOMP 
uses the value of profile variable base as the name of the 
base library* and if there's no such variable defined* 
GENCOHP uses the name base* 



(optional) User Name in whose catalog the base specified 

by b may be found* If you don't code the un parameter* 

GENCOMP uses the value of profile variable baseown as the 

name of the base library* and If there's no such variable 

defined* GENCOMP assumes that the base is in the current 
user's catalog* 



ab or a I i 

(optional) list of Alternate Bases from which to satisfy 
calls to common modules* The ab parameter may be coded as 
a ffluiti valued list of subllsts* Each element of the 
value list is either a single name* in which case it 
refers to the name of an alternate base already assigned 
to the job* or in the current user's catalog* fl£ an 
element is a sublist* in which case* the last sub element 
in the sublist is a user name I ?i whose catalog the bases 
referred to by the other sub elenents of the sublist may 
be found* The example at the end of this description 
should (with luck) make this clear. 



sf 



(optional) name of a Source File containing source text 
for one or more modules or coimon ^rjodules that are to be 
used in place of or in addition to the modules on the 
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specified baseCs)* If the sf parameter Is givent the file 
It specifies is the object of a *CREATE directive to 
HADIFY* Mfltfi * that If you don't code the m parameter 
(described above)* GENCOMP assui^es that the file specified 
by the sf parameter contains onie Cregurar) module and 
that* unlike the norwal case for* a HAOIFY source module* 
Its first line Is not the module nafiie but is the first 
line of data In the module Cin this case a default module 
name of SESQPT is usedl* If you don* t code the sf 
parameter* you must code the ■ parameter. 



cors or c s 

I optional) name of file containing CQRr'ect ion Sets to be 
temporarily applied against the base b orlor to generating 
the compile file. If you code the cor*s parameter* GENCOMP 
uses procedure TEMPCOR to make the temporary corrections 
before generating the compile file. 



seq or fioseq : 

(optional ) The default for GE^ICO^^P fs ^10 SEQence numbers 
on the compile file* and a comolle file width of 100 
(ASCII) characters. You can code noseq«vaiue to change 
the width* or you can code seq to get SEOuence numbers at 
a width of 100 characters* or you can code seq«yaiue to 
get SEQuence numbers at compMe file width of value 
characters. You control the seqjefics nunbers and width by 
defining the profile variables cfseq nn6 cfwldth. 



define or def s 

this (optional) parameter specifies a name or list of 
names to be ♦OEFINEd for reference by the *IFCAtL and 
*NIFCALL ••compile file" directives described above. 



status or sts : 

these (optional) Issxs are used for those cases where 
GENCOMP is being used as a building block of more 
sophisticated procedures or jobs. The status issjt causes 
GENCOMP to set the NOS job control register EFG to the 
value zero If GENCOMP successfully coiipleted* and non zero 
if anything went wrong during the run of GENCOMP. If 
status is not specified* the procedure will EXIT If an 
error occurs. 



cybccmn or cyblcmn : 

(optional) Jm specifies an of SES supplied Alternate Base 
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for use in satisfying calls to coimon ?sodules (see the ab 
pararaeter described above). If you code the cybccflin lij^it# 
the base containing CoHpoH modules for' use by CYSIi CC 
programs is selected. If you cods the cyblcan issi» the 
base containing CoMaion modules for' use by CYBIL CI progriams 
is selected. 8y defaults no base Is selected for use In 
generating the compile file. 

nest or nonest • 

these (optional) li£xs control whether nested calls to 
common modules are processed or Ignored. If you omit this 
parameter or code the nest K&X* GEMCO^P processes nested 
calls to common decks. If you code the nonest liax GENCOHP 
treats nested calls as ordinary lines of text. 



msg or nomsg : 

these (optional) iifiXS control the generation of 
informative messages by this procedur'e and are fully 
described in the section entitled "INFORHATIVE MESSAGES 
FRON SES PROCEDURES". 



nodrop 



if this (optional) hS.t is coded* It specifies that an 
"unknown*' common deck (one that couldn't be found during 
the compile file generation) Is not considered to be an 
error* otherwise it is. MiliS * other errors are also 
ignored if nodrop Is g I vent so use this feature at your 
own risk. 
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Examples of GENCOHF Usage 

ses«gencomp nexlinr 

* SEMiRATIMG COHPIIE FILE NEXIINR 

REVERT. END GENCQHP COMPILE <- 0UR8ASE 

This example shows the stsiplest use of GE^COHPf generating a 
compile file for a module nexl I nr. Since the m oarameter of GENCOMP 
is the first positional parameter* we can oiit the m keyword. There 
Is no base specified In the example siftce there Is a directive 
I i ke t 

\ base » •OURBASE* 

In our profile. When GENCOMP has finished* the cienerated corapile 

file appears on the file compile. The next exawple is more 

complicated* it shows the use of multiple niodulas and alternate 
bases used to generate the compile file* 

ses.gencoiip (asterlx» obel ix«.9etaf ix)> b«gauH ab«(ha5Pf •«•« 

♦ •? Cgrasp» cicsy powers Ir69)» alios I 

♦ GENERATING COMPILE FILE COMPILE 
REVERT. END GENCOMP COMPILE <- GAUL 

This example generates a compile fife for inodules asterix* and 
all modules obetix through getafix in the base called gaut . 
Alternate bases hasp and mllos are to be obtained from the current 
user's catalog* and alternate bases grasp* eles and power are to be 
obtained from the catalog of user If69. The conolle file appears on 
file compile. The example also Illustrates the use of continuation 
lines* showing the rauiti valued ab par ameter spI I t across lines. 

ses.getfflods Cspecialy general)* b»theoryr lufted; •• 
••? gencomp Cspeclal* generally cf«albert* sf«group» •• 
••I b»theory* def ln8«lorentz» seq«79 

♦ GENERATING COMPILE FILE ALBERT 
REVERT. END GENCOMP ALBERT <- THEORf 

In this example modules special and general are extracted from 
base theory onto file group and edited. Then a compile file is 
generated for the edited version of the modules (via the sf 
parameter) with the lorentz ••option" defined. The resulting file 
albert will have sequencing information to the right of column 79. 
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SF 
fife containing 
sovrce modules 



CF 
-> C com pi le 
file) 
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CORS 
temporary 
correction sets 






GENCOMP generates a compile file for modules which may come from 
off the base (the m parameter)* or frb?i! a source file (the sf 
parameter)* or from both places. The ab paraiieter specifies a list 
of alternate bases to be used to get commoi decks from. A temporary 
correction set may be applied (the cors paraneter) via the TEMPCOR 
procedure before generating the compile fife. 
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5.5 GENCOR OR GENCORS - GENERATE CORRECTION SETS 

GENCCR and GENCORS are synonyms for a prbcedire that GENerates a 
CORrection Set for a module. Parameters to GENCORfSI are ? 



ii t 



b or I 



un i 



name of the Nodule within the base library b for which the 
correction set Is to be generated. Also* m Is the default 
name of the file <elther local or In your catalog) which 
contains the new version of the nodule <see the sf 
parameter described below). 



Coptional) name of Base contaJnlnci the module specified by 
m for which the correction set Is to be generated. If you 
don't code the b parameter* GE^CORCS) uses the value of 
profile variable base as the na?na of the base library* and 
if there's no such variable defined* GENCOR(S) uses the 
name base. 



(optional) User Name where the base library specified by b 
is to be found. If you don't code the un parameter* 
GENCORCS) uses the value of profile variable baseonn as 
the user name in whose catalog b Is to be found* and if 
there's no such variable defined* GENCORCS) assumes that 
the base library Is in the current user's catalog. 



cors or c s 

(optional) is a file containing a CORrection Set to be 
applied against the base b before the module m is 
extracted. If you code this parameter* SES procedure 
TENPCOR is used to apply a TENPorary CORrection set. Note 
that TEMPCOR doesn't actually alter the base* the 
correction set is only applied for the duration of the 
GENCORS run. 



ncors or nc s 

(optional) name of file to receive the New CORrection Set. 
If you don't code the nc parameter* GE'^CORCS) uses the 
name ncors for the new correction set file. 



Id 
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^optional) IDent name for the GE'^CORS *IOENT directive in 
the generated correction set. Id can be any character 
string that foriBs a valid HOOIFf correction identifier. 
If you don't code the id paraiietar* GS^CORS generates a 
uni<|ye correction set identifier.^ 



sf 



this (optional! parameter specifies tlie ia?se of the file 

containing the new version of the i?iodyi*fe. If you don't 

code the sf parameter* GENCQRCSI uses the nafse specified 
by the m parameter as the Source File nane. 



is or Ignorls : 

these (optional) Isfiis specify whether or not to XMQSe 
Leading ^Paces on lines being compared. I The default action 
Is to recognize leading spaces (the Is option). If you 
code the ignorls ii£X# GENCQRCS) Icjr^ores leading spaces on 
text I Ines* 



fl 



(optional) parameter to Increase the ^iefd length* If you 
don't code the fi pararoeterf GENGIR(S) defaults to a fieid 
length of lOOK. 



nsg or nomsg : 

these (optional) K&X.SL control the generation of 
informative messages by this or'ocedure and are fully 
described in the section entitled "INFORMATIVE MESSAGES 
FROM SES PROCEDURES". 



Example of GENCOR(S) Usage 

ses*gencors msnice* b«neat# un«by73» nc«corset 

♦ GENERATING CORRECTION SET FOR NICE ON CORSET 

REVERT. END GENCORS NICE— > CORSET 

This example shows a correction set being generated for module 
nice. The original module is in base neat In the catalog of user 
by73. 
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Sjij.il£M>al.££!l£llEiil 



H 
file containing 
nem modyle 



mmmmMmxMmm ■m-m-mm m 

B 
Base containing 
old module 



/ V 



•>l 



99MMMM *M MM MMmmm 

CORS 

(temporary -- 

correction set I 



5/ 



NCORS 
— > (neM 
correction set) 
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— + 



The picture shows the flow of 6ENC0R<SI. The file containing the 
new module M is in the user^s catalog.^ The old version of the 
module is in the base B. An optional temporary correction set 
(CORS) may be applied if desired^ in which case 5ENC0R(S) uses the 
TEMPCOR procedure to apply the correction set before generating the 



new correction 
parameter. 



set* which appears on the file specified by the ncors 
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TEMPCOR makes temporary oorrections to a base library* without 
permanently updating the library^ providing checkout of the 
corrections applied before permanent modifications are made. 
Parameters to TEMPCQR are s 

b or I ! 

name of Base Library against which the corrections are to 
be applied. If you don't code the b paraweter* TEMPCQR 
uses the value of profile variable base as the name of the 
base tibraryf and if there's no such variable defined* 
TEMPCQR uses the name base. 



un : 



(optlonall User Nasie In whose catalog the base library 
specified by b way be found* If you don't code the un 
paraaieter* TEMPCQR uses the value of profile variable 
baseoMn as the user naae where b fflay be found* and If 
there's no such variable defined* TE1PC0R uses the current 
user's catalog. 



cors or c s 

naiae of file containing the CORectlonS to be applied 



against b. 



msg or nomsg : 

these (optional) lifiis. control the generation of 
informative messages by this procedure and are fully 
described in the section entitled "INFORMATIVE MESSAGES 
FROM SES PROCEDURES". 
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Example of TEMPCOR Usage 



ses«teiiipcor b«hi$basey un«nr06# c«corsets 

♦ CREATING TEHPORARY BASE 

* TEMPORARY BASE NOW BEING USED 
REVERT* END TEHPCOR CORSETS -> HIS8ASE 

This example shows the correction set corsets being applied to 
the base hisbase* The base hisbase Is left local to the job» such 
that further references to hisbase actually use a temporary copyf 
and not the original* 
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5.7 llQI2i£X.r«U£l^lI£-SM£.Miia«(IQ£S£aiflil.aSIili 

MODIEV is intended to take a correction set fll% and update a 
base library with the correction sets contained therein* Parameters 
to MODIFY are t 



cors or c or I 8 

name of file containing the CQRrection Set<s) to be 
applied against the base specifiad by the b parameter. If 
you don«t code the cors paraineterf MODIFf uses the name 
cors* 



b or I 



(optional) nasie of Base to be undated frbm the correction 
set file* If you don't code the b parameter* MODIFY uses 
the value of profile variable base as the name of the 
base* and if there's no such variable defined* MODIFY uses 
the default name base* 



nb or nl s 

(optionan name of New Base to be created when the update 
has been completed* If you don't code the nb parameter* 
MODIFY uses the value of profile variable nenbase as the 
name of the new base* and if there's no such variable 
defined* MODIFY writes the ne^i base over the old base 
specified by the b parameter* 



io 



this (optional) parameter specifies the Iptions to be used 
when producing the Listing* Each designator selects an 
option to a maximum of seven options* The designators 
must not be separated* OesignatDfs ares 

a list active lines in deck 

c list directives other than INSERT, DELETE* RESTORE* 
MQONAME* I* or 

d list deck status 

e list errors 

i list inactive lines in deck 

m list modifications perforiied 

s include statistics on listing 

t list text input 

w list compile file directives 



un 
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(optional) User Nsrae in 5#hose cttatog the base specified 
by b/nb is to be found* if b/nb is not in the catalog of 
the current user* If you don't code the un paranaeter* 
MODIFY uses the value of profile variable baseotin as the 
user nawe from whose catalog the base is to be obtained* 
and if there's no such variable defined* MODIFY uses the 
current user's catalog* 

I ock or nolock i 

these Coptlonal) paraiueters deter^ilne whether the base 
update process is interlocked against simultaneous updates; 
coding a filename for the lock oarameter determines the 
name of the interlock file. liter locki ng is the il^f^iill 
action when the base being updated Is In another user's 
catalog* If you don*t code either of the lock or nolock 
liSXS.9 interlocking is controlled by the lokmode profile 
variable* Refer to the introductory sections of this 
chapter for information on the interactions of the loknode 
profile variable and the lock and nolock parameters* If 
you don't code a filename for the lock parameter* the 
contents of profile variable Intrlok Is used as the 
interlock filename; if there's no such profile variable* 
the name Intrlok Is used as the lock filename* The 
interlock file iMSi he In the snne catalog as the base 
being updated* If the interlock file carinot be found* the 
procedure aborts* 



batch Job parameters : 

These parameters are described In the section entitled 
"SES PROCEDURES RUN AS BATCH JO^S«. The default for this 
procedure is to run in local modsf but it can be run in 
batch mode* The dayflle parameter Is not used by this 
procedure* 



msg or nomsg t 

these (optional) K&xs. control the generation of 
informative messages by this orbcedure and are fully 
described In the section entitlad «IMF3RMATItfE MESSAGES 
FROM SES PROCEDURES"* 
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5.7 HOOIFY ~ UPDATE BASE WITH CORRECTION SETfSI 

Example of MODIFY Usage 

ses.niodlfy b^dusbase c^corslib 

* APPLYING C0RSLI8 TO DUSBASE 

* NEW BASE ON SESTMPB 

* NEW BASE NOW ON DUSBASE 

* SESTHPB PURGED 

REVERT. END NQDIFY CORStIB -> DUSBASE 

This example shONS a correction set file called corsllb applied 
against a base library called dusbase. 
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5.8 CATBASE - PRODUCE LIST OF MODULES IN A BASE LISRARY 

CATBASE Is used to display a ilst of the ifiodyles in a base 
library* CATBASE outputs the modules list In a condensed format* 
four modules per line* shoeing only the wodule names and their type. 
Parameters to CATBASE are : 



b or I 



un t 



(optional) name of Base Library »hlch Is to have its 
module names displayed. If you don't code the b 
parameter* CATBASE uses the walue af profile variable base 
as the name of the base* and if there's no such variable 
defined* CATBASE uses a file naiie of base. 



(optional} User Name In wliose catalog the base specified 
by the b parameter Is to be found. If you don't code the 
un parameter* CATBASE uses the value of profile variable 
baseoMn as the user name* and if there's no such variable 
defined* CATBASE uses the current user's catalog* 



(optional} name of file to r*ecelve the Output from 
CATBASE. If you don't code the o parameter* CATBASE 
places the module list on file output. 



short or long : 

these (optional) lifiis. determine the format of the output 
from CATBASE. If you omit this Parameter or code the 
short JS£i* CATBASE produces its output In the form shown 
in the example below. If you code the long lifil* CATBASE 
produces its output in the same format as the NQS utility 
CATALOG. 
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5*8 CAT8ASE - PRODUCE LIST OF MODULES IN A BASE LIBRARY 



Exataple of CATBASE Usige 



ses*catbas 
DOUSiRH.* 
DUSCODH,, 
OUTEXTP*. 
DUGOODY** 
OUSYNTX.. 
DUUPOAT,. 

REVERT, 



e b«dasbase un*vb55 
OPL 0UINTRO..OPLC 

OPLC DULIBR«,,OPLC 

OPLC DUHAILB.«QPLC 

OPLC DUPROFL^.OPLC 

OPLC DUAaUXR«.OPLC 

OPLC QPL.«.«««OPL0 

END CATBASE DUSBASE 



OUPRIHT.^OPLC 
DUFILf*1.,0PlC 
OUHULTI.bOPlC 
DUMOOES^bOPLC 
DUXTRACwwOPiC 



DUFQRHT*,OPLC 
OUCOHPL^.OPLC 
OUCONVS..OPLC 
0UNES6S..0PLC 
OllOONS&.«aPLC 



This example shows CATBASE output for base library dusbase In the 
catalog of user vb55* Regular siodules are Identified by the type 
code OPLf and common modules are Identified by the type code OPLC. 
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5 . 9 LiaiBQa^=^LliI-£QIII£MIi-a£«iM£ 

LISTMOD performs two sfjain functions s ta show you what's In a 
base* and to get a printout of the modules In the base If necessary. 
LISTMOD first generates a cross reference of the baset showing which 
rnodutes call which ivodules* and which niodafes are called by which 
fflodyles ILISTHOD uses procedure XREFMQO to generate the cross 
reference - see the description of XREFilO if you're interested)* 
Lastly* LISTMOD generates a printout of all modules or common 
modules In the base— you can suppress this If you only want the 
cross reference without the whole base's cantsfits. Paraffleters to 
LISTMOD are s 

b or I : 

loptlonal) name of Base to be processed. If you don't 
code the b parameter* LISTMOD uses the value of profile 
variable base* and if there's no such variable defined* 
LISTMOD uses the default name base* 



Coptional) name of file to receive the Output from 
LISTMOD. If you don't code the o parameter* a scratch 
file is used for the output and Is returned once It has 
been printed. If you code the o parameter and LISTMOD Is 
run in local mode* the output Is olaced on the specified 
file and is Qfit printed unless the print parameter Is 
given. 



un i 



(optional) User Name in whose catalog the base specified 
by bis to be found. If you do'i't code the un parameter* 
LISTMOD uses the value of profile varlablia baseown* and If 
there's no such variable defined* LISTMOD uses the user 
name of the current user. 



batch Job parameters t 

These parameters are described In the section entitled 
«SES PROCEDURES RUN AS BATCH JOBS«. The default for this 
procedure is to run In batch mode» but It can be run in 
local mode. The dayfife parafiieter Is not used by this 
procedure. 



print : 



(optional) indicates how the output of LISTMOD Is to be 
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5*9 LISTMOD - ilST CONTENTS OF BASE 



printed* For the print parameter you may code any of the 
parameters to procedure PRINT. If you don*t code the 
print parameter at all* IISTMOD orlnts one 111 copy of the 
output on the ASCII printer. 



short or comAon i 

these Coptional) k&XS. control which taodules are listed 
following the cross reference of the base.* if you omit 
this paraflieter* LISTMOD lists the source for all aiodules 
in the base* If you code the coupon ^&t» LISTHOD lists 
only the coflnaon modules from the base. I If you code the 
short ii£X* no modules are listed (l.e.» only the cross 
reference is produced)* 



Exampies of LISTNOD Usage 

ses«listaiod prlnt«copies«39 short 

1X*17*34. SUBMIT COMPtETE* JQBNAHE IS AVQPS'JG 
REVERT. JOB LISTHOD SUBHITTEO 

This example shows LISTMOD processing the base whose name is 
contained in profile variable base. Three copies af the short list 
Icross reference only) are produced. LISTMOD Is run in batch» 
rather than Interactively. Running LISTMOD In batch is the 
preferred mode* since it uses rather a large anount of resources. 



ses.ilstmod b«cidbase# o»ci dprln» ••••I. 

••? pr int«<copies«2» h««latest/verslon of/cldbase«l 

10.19.57* SUBHIT COMPLETE. JOBNAME IS ACULBXG 
REVERT. JOB LISTMOD SUBMITTED 

This example shows LISTMOD run In batch to produce two printouts 
of the cross reference of base cldbaset plus the text of all the 
modules In cidbase. 
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SaO SORTHOD - SORT BASE INTO ALPHABETICAL 3R0ER 

5.10 sa£If|||l2^=-SaEI-.aM£.Iiia-4L£aiB£Ii£iL.3111E 

SORTHOO rearranges a base sucli that all the lodul es appear In the 
base In alphabetical order. This Is a yery useful facility* for 
when a base becomes large and has a large Timber' of modules in Itf 
lt»s easier to find aiodules In the base If they're In some regular 
order. Parameters to SORTWOO are ? 

b or I ? 

(optional) name of Base to be sorted. If you don't code 
the b paraineter* SORTHOD uses the value of profile 
variable base* and If there's no such oroflfe variable 
defined* SORTMOO uses the naiae base. 



nb or nl 



un 



edtsort 



Coptionall name of New Base to be created at the end of 
the SORTMOO run. If you don't code the nb paraflieter* 
SORTMOO the value of profile variable newbase. If there's 
no such profile variable defined* SORTMOO writes the new 
base on the file specified by the b oaraueter. 



(optional) User Name in whose catalog the base specified 
by b/nb Is to be found* If b/nb Is not In the catalog of 
the current user. If you doi« t code the un parameter* 
SORTMOO uses the value of profile variable baseo»tn as the 
user name from whose catalog the base is to be obtained* 
and if there's no such variable defined* SORTMOO uses the 
current user's catalog. 



(optional) name of file to receive the Output of the 
programs used to run SORTMOO. If you don't code the o 
parameter* SORTMOO sets o«0* or r^o output. This Is 
usually the desirable default* since the sort process 
generates large volumes of output.' 



• 

(optional) pair of filenames representing the Input and 
output files for the EDI text editor. You use edtsort to 
EDIT the SORT output to Impose your' own ordering on the 
modules in the base. 
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lock or notock $ 

these Coptionan paraweters determine s«Nether the base 
update process is interlocked against simultaneous updates! 
coding a filename for the lock aaraiBeter determines the 
nawe of the Interlock file. Intsrlocklng is the illt£iitil 
action when the base being updated is In another user*s 
catalog. If you don*t code either of the lock or nolock 
ilSlS* interlocking is controlled by the lokmode profile 
variable. Refer to the introductory sections of this 
chapter for inforination on the interactions of the lokmode 
profile variable and the lock and nolbck parameters. If 
you don't code a filename for the lock paraweter* the 
contents of profile variable Intrliik Is used as the 
interlock filenatiie; if there's no such profile variable* 
the naipe Intrlok Is used as the lock fllenaise. The 
interlock file iMSi be in the sane catalog as the base 
being updated. If the inter lock f 1 1 e cannot be found* the 
procedure aborts. 

batch Job parameters : 

These parameters are described i '% the section entitled 
"SES PROCEDURES RUN AS BATCH Jl^S". The default for this 
procedure is to run in local inode. but It can be run In 
batch fflode. The dayflle paraneter* Is not used by this 
procedure* 



nsg or noinsg : 

these (optional) KfilS. control the generation of 
informative messages by this arbcedure and are fully 
described in the section entitled «INE1RMATIVE MESSAGES 
FROH SES PROCEDURES'*. 



5-43 

CDC - SOFTyARt ENSINEERING SERVICES 

18 Oecember 84 
SES User's Han<lbook REVs 4A 

5,0 SOURCE TEXT MAINTENANCE 

5,11 yiPEMOD - DELETE HQOUIECS) FROM BASE 



5*11 iil££l!ai.=^a£iII£-aQSilL£Xli^£tQll.IM£ 

WIPEMOO is intended as a means of deleting inodulefs) from a base* 
Parameters to WIPEMOO are s 

b or I : 

{optional) name of Base froi vihlch modulefs) are to be 
deleted* If yoy don't code the b pnrsmetnr $ WIPEMQO uses 
the value of profile variable base as the name of the 
base* If there's no such prisfife variable defined^ 
V^IPEHOO uses the name base as the nawe of the base* 

nb or nl : 

(optional) nafne of New Base ta be created at the end of 
the WIPEHOO run* If you don't code the nb parameterf 
WIPEHOD uses the value of profile variable neitbase as the 
name of the new base* If there's io s«c?i prof i le variable 
definedf WIPEHOD places the ?iew base back over the old 
base specified by the b parameter*. 



un 



(optional) User Name In whose catalo?i the base specified 
by b/nb Is to be found* If b/nb is lot In the catalog of 
the current user* If you don't code the un parameter* 
WIPEflOD uses the value of profile variable baseoMn as the 
user name from whose catalog the base is to be obtained* 
and if there's no such variable defined* WIPEHOO uses the 
current user's catalog* 



or com or opic t 

(optional) list of COHmon moduleCs) to be deleted* 



r or reg or opi : 

(optional) list of REGular or OPL uodul e( s ) to be deleted* 



lock or nolock : 

these (optional) parameters determine whether the base 
update process is Interlocked against simultaneous updates; 
coding a filename for the lock^ oar ameter determines the 
name of the interlock file* Interlocking is the iiefjilli 
action when the base being uodated Is In another user's 
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catalog* If you don't code either* of tfie lock or nolock 
llOS> interlocking is controlled by the lokmode profile 
variable* Refer to the Introductory sections of this 
chapter for information on the Interactions of the tokmode 
profile variable and the lock and nolock parameters* If 
yoy don*t code a filenafne for the lock par ameter* the 
contents of profile variable Intrldk Is used as the 
Interlock filename; If there's no such profile variables 
the name intriok is used as the l^ck filenarse* The 
interlock file iiiS.t be In the saie catalog as the base 
being updated* If the inter I ock fi I e cannot be found* the 
procedure aborts* 
batch job parameters « 

These parameters are described in the section entitled 
♦•SES PROCEDURES RUN AS BATCH JOB?"* The default for this 
procedure Is to run in local lode* but It can be run in 
batch iBOde* The dayflle parameter is not used by this 
procedure* 



msg or nomsg : 

these (optional) lifiXS control the generation of 
Informative messages by this or'ocedure and are fully 
described In the section entitled ••IWFORHATI VE MESSAGES 
FROM SES PROCEDURES*** 



Exanple of IIIPENOO Usage 

ses«Mlpemod aiybase c«lcdeckay cdeckb) r«()naln«*!street» cond) 

♦ DELETING MODULES FROM MYBASE 

♦ NEW BASE ON SESTMPB 

* NEW BASE NOW ON MYBASE 

* SESTMPB PURGED 

REVERT. END WIPEMOD MYBASE 

This example of WIPEMOD deletes cofBoionnodules cdecka and cdeckb 
from the base mybase. It also deletes regular modules main through 
street inclusivef and regular module cond* The example illustrates 
the sort of informative messages output by WIPEIOD.i 
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5.12 XREFHQO - CROSS REFERENCE OF A BASE 



5 . 1 E JSEI£aQfi.r.QBI251>Bl££SiM£I.Qf -A«MS£ 



XREFMOO produces a cross reference listlrig of a base. (XREFMOO 
Is prifliariiy intended as a "building block** for other procedures* 
In particular* see the description of tlie L1ST10D procedure wfilch 
runs XREFHOD as a batch job.) 

Optionally* a single module Ideckr name can be specified for 
which are produced C instead of the normal output listing) a list of 
the regular modules that reference {call) the module either directly 
or indirectly Isee the description of the m parameter for more 
inforiaation on this feature). 



In the nort 
output* XREFMOO 
Information s 



al (i.e.* not the single module 
produces for each MOOufe (deck) 



option) mode of 
the following 



1. the name of the deck 

2. the date on which the deck was created 

3. the type of deck isee deck categories described below) 

4. the number of lines in the deck 

5* the position of the deck in the base 

6. a list of all the decks that reference (call) this deck 

7. a list of all the decks that are referenced (called) by this 
deck 



Items 2 through 5 are replaced 
'•external*' to the base being cross 
one which is referenced (called) by 
but which is not itself contained 



by a '•flag" if the deck is 
refer a'iced. An external deck is 
one or* more decks in the base 
in the base.? A separate list of 



all the external decks is produced fol lowing the main deck list. 

In I terns 6 and 7* a deck name may be preceded by 'I* indicating 
an Indirect reference* and/or by •** indicating an external deck. 



All deck lists are arranged In alohabetlcaf order 
width and page length are selectable via par*ameters. 



The page 
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Modules are categorized according to the following criteria * 

+-.— — -.«— . — -.—- .+-.««-^-— ..-— «™..-*^-««™«»— .—- .w — •^-^ — «— ^— «.— — ««+ 

• a • 

4.««-«^^.-. «- + -«^— ^ — .-- .^™— ^— -., ,«^«^— .^^— ™«« < «.-.— «4 

• « * 

• t « 

• COMMON t common deck I 



J MODULE I first prograia line Is a MODULE line 

« • 

a « 

i IDENT I first program line is an tDENT fine 



PROGRAM I first program line Is a PROGRAM fine 



SESPROC ! first two characters of the first program line J 
S are 'X •> that ls> the SES processor master J 
' control character followed by a space* » 



TXTFORM ; first character of the first line is a reverse J 
J slant (\) ? 



} KCL J first character of the first Mne Is an asterisk 
J ! C*) and not i miiiedl ately followed by ••CAIL"^ 

J J "CALLC^j "IFCALL", or WNIFCALL"* 



CCL 5 first line Is a •PROC ll?ie 



« 
« 

UNKNOWN « lyou guessed it) none of the above 



t 



I 



* Up to five lines are examined If the first separator character 
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5.12 XREFHOD - CROSS REFERENCE OF A BASE 



of the prevloys lioeCs) Is a double quote f*»l or a question 
mark t?)* 



Parameters to XREFHQD are s 

b o r I s 

Coptionai) n^me of Base Library for which the cross 
reference is to be generated. If you don't code the b 
parameter* XREFMOO uses the yafus of profile variable 
base* and if there's no such variable defined* XREFHOO 
uses the default name of base* 



un 



(optional) User Name in whose catalog the base specified 
by the b parameter is to be fou^id. If you don't code the 
un parameter* XREFHOD uses the value of profile variable 
baseonn as the user name* and if there's no such variable 
defined* XREFHOD assumes that the base is in the current 
user's catalog. 



(optional) name of file to receive the Output from the 
cross reference run. If you don't code the o parameter* 
XREFMOO sends the output to file OJT^JT. 



n or mod : 

(optional) name of a module (possi hi y external ) for which 
a list of the reguiar modules that reference (call) It 
either directly or Indirectly are oroduced. Each module 
name is written on a separate line with a space in column 
1* the module name In columns 2 through 3 (left justified* 
space filled* with letters in upper case) and a period (.) 
in column 9. The module names ar*e written in alphabetical 
order . 



pw or pwidth i 

this (optional) parameter specifies the Page Width for the 

cross reference listing. If you code this parameter* you 

must give a value of at least TO.' If you omit the pw 

parameter* XREFMOO uses a page width of 132, 

pl or plength : 

this (optional) parameter specifies the Page Length for 
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the cross reference listing* I^ you code this parameter* 
you iRust five a value of at least 20* If you omit the pi 
pararaeter^ XREFHOD uses a page 1%r><|th of 50* 
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5«13 GETCQMN - ACQUIRE CY8IL CQHMQN DECK LIBRARY 

GETCOMN acqyiras the i atest MADIFY or SCJ vsrslan of the CYBIt CC 
or CI coffl!«on deck library as a local file naued CY3CCHN or CYBICMN - 
parameters to GETCOHN are s 

mad or scu s 

this loptlonal) Js^i indicates the fortnat of the CY8Ii CC or 
CI common deck library desired* If you tiotie the mad kSl* 
the MAOIFY foraaatted version of the coi^nnon deck library is 
made local* If you code the scu iiai o^ do not code either 
of these keysf the SCU formatted version of the cowtaon deck 
library is inade local. 

cc or ci s 

Coptionai) |i£i Indicates the version of the CY8II cofsmon 
deck library Is desired* If you code the cl iSjBj:* the HADIFY 
or SCU forroatted CYBIl CI common deck library is made local* 
If no key is coded* the NAOIFY or SCtJ foriHatted CYBIt CC 
co^nmon deck library is made local* 

You may also define PROFILE variables to override the default 
file assignments for the various forms of the CYBTl common deck 
library* For the CYBIL CC version the PROFILE variables should be i 

ccmn CY8£CMN in MAOIFY format 

ccmnun owner of •ccmn* 

ccscu CY3£CMN in SCU format 

ccscun owner of *ccscu* 

For the CYBIL CI version* the PROFILE variables should be : 

Icflin CYBICMN In MADIFY format 

icnnun owner of «icmn» 

Icscu CYBICMN in SCU format 

icscun owner of •icscu* 



Examples of GETCOHN J^age 



ses«getconin 

REVERT, SCU VERSION OF CY8CCMN MADE tOCIL 
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ses.getconn nad ci 

REVERT. MAOIFY VERSION OF CYBICMH MADE LBCAi 

The first example sho*ts GETCQHN acqylr1f>g tNe SCU version of 
CY3CCHN (both parameters take their defamltsJ. The second example 
shoiis how to acquire the MAOIFY version of CYBICM!^. 

Hfli^ : please ensure that you RETURN the comion deck library ^Hen 
you* re finished «lth It. 
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5.14 iIiI£ll^r-i2Li2MLiI-k£aSS«E££f iiM££l-i .IIllL -IXIIEII 

SYSTEMX <a HAOIFY based CYBIL system orbss reference facility) 
initially builds a data base containing a global cross reference of 
all CYBIL Modules which reside on a specified set of MADIFY Pt»s. 
Then SYSTEMX cans 

1) query the data base for 4nform?it1on pertaining to a CYBIL 
identifier or HAOIFY deck name 

or 

2) output the entire data base to nine-trackf high-density (GE) 
tapels) in a format suitable for microfiche processing at 
Consource Headquarters. 

The tape(s) made froin running SYSTEHX ?4lth the fiche parameter 
specified should be sent «ith a *Hicrofltii Worl? Re<iuest* (form no* 
AA5167) to Terry Larson - HQCOOH. The 'Program ID* used on the 
*HicrofilrR Work Request* Is ARH144* A «*1aster' Charge No** is also 
required to submit the 'Microfilfn Uork Request*. Please contact 
Kathy Beatty C432-2338) for Information needed to acquire a *Master 
Charge No.*. 

If building the data base* the default Jobnode Is batchn and 
either the build or restart paraaieter roust be qlver^.' If writing the 
data base to microfiche formatted tape* the default jobtnode Is 
batchn and the fiche* sysnane and vsn paraneter's nust be given when 
beginning the job* or Just the flche parameter when restarting the 
job. If neither the build* restart or flche parameter is given* 
then SYSTEfiX assumes the query function where the default Jobwode is 
local and either the identifier or deck paraaieter' ^ust be given. 

The parameters in effect are 5 

product*pd 
bui Id 
bases*ba 

packnani*pn 
ffloduies*md 
restart 

Phl*ph2»ph3*ph4 
batch job parameters 

The permanent files left in your catalog after phase4 completion 
are s 
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SYSX81..SYSXBn where 1 i N £ 99 equals the total fiumber of 

HAOIFY RL«s input during the build 

and 

SYSXRST SYSXPHl SYSXDKS SYSXDRl 
SYSXORH SYSXSRT SYSXHST SYSXTMP 
SYSXTXT 

Of these permanent files* only s 

SYSXRST SYSXTXT SYSXHST SrSXTMP 
SYSX0R2 SYSXSRT SYSXDRl 

are required as Input to the query or fiche functions. 

The remaining permanent files J 

SYSXBL.SYSXBn SYSXPHl SYSXD<S 

which were created during phasel of the buHd should be retained 
only if a subset of your system was cross raferanced via the product 
parameter and you will create another sub-systen cross reference 
later* Then retention of these files saves having to run phasel of 
the build over again* 

Note that all of these files can be du?»ped to tape via the 
SES*OUMPPF procedure and then restored via the SES.iOADPF procedure* 
If these files are dumped from one catalog and restored into 
another* then text line two of file SYSXRST must be changed to 
reflect the new user.number* 

Should the build require more than one processing session to 
complete (i.e.* restartfsM* then some per'«anent files left by 
SYSTEMX in your catalog will begin with »ZQ« and others with *SYSX«. 
Please note that prior to beginning a SYSTEMX build* all of the 
above mentioned filenames beginning with 'SYSX* must be purged from 
your catalog. 

Between restarts of the build function* users are strongly 
encouraged to backup on tape what has been produced up to that 
point* NOS could go down for the night or* crash before SYSTEHX 
shuts itself down* In which case all has been lost if previous 
output wasn't backed up to tape. To deteriiine which files to dump* 
simply list file SYSXRST and match file nanes from that list to 
those in your catalog. Dump those files w'llch Tiatch and also file 
SYSXRST. 

Phasel Description : 
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Phasel creates a new set of MADIFY based Pi's s^hich are afjaost 

identical to the original set of PL's Input. Tlie ilfference Is that 

comments noiti bracket the text of each deckhand contain information 
about the deck's origin. 

SYSTEHX must complete phasel and shut Itself down pending a 

restart during one processing session. If your' system is large* 

then eight or raore hours of wall clock tine should fee available for 
processing «hen you begin this phase. 

Phas€2 Description : 

Phase2 creates and sorts the Initial set of files required by 
phases. SYSTEHX must complete phase2 during one processing session* 
though the wall clock time required is very short. 

Phase3 Description 5 

Phases performs the bulk of the build orocess. Each CY3IL module 
in your system Is built* CYBFORHed* compiled and fed Into the global 
cross referencing logic* SYSTEHX defaults to perform this phase In 
100 module Increments after which It vol tjrtttri I y shuts Itself down 
pending a subsequent restart. 

The 100 module default can be changed at any restart occurring 
before phase3 completion to any number fron I to 9^999* depending on 
the amount of processing time available. Please note that the last 
figure selected remains In effect during subsequent phase3 restarts 
If a new figure isn't selected at that tliie via the modules 
p ar am et er • 

SYSTEHX must complete phases or voluntarily terminate after 
processing a preset number of modules. On a moderately loaded CYBER 
176* SYSTEHX can process about 30 modules p^ir "lOur of wall clock 
time* Of course* this can vary dramatically depending on the load* 

Phase4 Description : 

Phase4 performs the sorts and merges necessary to draw the global 
cross reference together. SYSTEHX must coiolete phase4 during one 
processing session. If your system Is targe* than eight or more 
hours of wall clock time should be available for processing when you 
begin this phase. 
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The parameters in effect are i 

f Iclie 
entries 

sysnane 
sysverslon 
sys level 

vsn 

batch job parameters 

Output from the fiche function goes to nine-track, high-density 
tape or tapes containing one to many files. The iiiportant thing you 
as the user need do is Insure that the reels are externally nuasbered 
sequentially (I.e.* one# two, three* etc.) as they coj»e off the 
drive. This sequencing function raust continue through flche 
restartCs) Ci.e.> do not start sequencing back at one if flche 
restartCs) are necessaryl. Also, mention to the o9erators to 'blank 
label a tape* If necessary. 

If output of the data base to tas>e requires wore than one 
processing session to coiaplete CJ*e.# flche restartCsH* then 
SYSTEliX » i I I leave a permanent file in your catalog called SYSXFCH. 
If this file exists in your catalog, then you are not finished yet. 
SYSTEfIX defaults to process the data base In 15»000 entry increments 
after which It voluntarily shuts itself do«fn oending a subsequent 
restart • 

The 15,000 entry default can be changed at the beginning of the 
flche job or at any subsequent flche rastar't via the entries 
parameter to any number from 1 to 99999, defending on the amount of 
processing time available* Please note that the last number 
selected remains in effect during subsequent flche restarts If a new 
number Isn't selected at that time via the entries parameter. 

SYSTEMX must complete the flche job or vofuntarlly terminate 
after processing a preset number of entries. On a moderately loaded 
CYBER 176, SYSTEMX can process about 2000 entries oer hour of wall 
clock time. 

The microfiche themselves will have two sections. The Source 
Deck section will consist of a sorted set of deck reports as 
described under the query function, fhe Global Crossraf section 
will consist of a sorted set of identifier reports as described 
under the query function. 

Between fiche restarts users are strongly encouraged to copy file 
SYSXFCH to another indirect access file in their catalog. If NOS 
goes down for the night or crashes before SYSTEMX shuts Itself down, 
then SYSTEHX can properly restart only if file SYSXFCH can be 
restored to it's condition prior to the flche restart which failed. 
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If a fiche restart faiis# simply restore file SYSXFCH to it»s 
condition prior to that restart and atteupt another fictie restart* 
Those tapes associated with the restart which failed should be 
re-used beginning with the lowest nunbereil tape* If the fiche 
function fails during the Initial processing session* then purge 
file SYSXFCH and start over using the absolute lowest numbered tape. 

Ill &.^M££ie.£ UQiii Ian 

The parameters in effect are : 

identif ierf id 

outputs o 

quaff 

deck 

batch job parameters 

Any user can query a SYSTEMX data base. Only a copy of file 
SYSXRST must reside in that user's catalog. Line two of SYSXRST 
must contain the user.nufliber of the catalog where the entire data 
base actually resides and the user must be validated to read those 
files. 

Identifier Report i 

For all CY8IL identifiers^ except modufe Identifiers^ a complete 
systeffl-wlde cross reference report is returned. For a module 
identifier* an unabridged compile file and standard CY8IL cross 
reference report is returned. 

Oeck Report J 

Different CYBIL identifiers* each bearing the sane name* can be a 
common occurrence within a CYBIL system. SYSTEMX qualifies each 
identifier and each reference to that Identifier by deck. name* 
base.name* user^name* and deckel i ne. number . 

The deckel ine_number corresponds to the line nunber as the phase3 
build received the deck. The comments placed around each source 
deck during phasel build* and potentially the CY^FORMIng process* 
have altered the one-to-one relatlonshlo to line numbers on the 
original source decks so SYSTEMX makes available a listing of each 
source deck as phase3 received it to restore that one-to-one 
relationship to the user. 

Parameters to SYSTEMX are 5 
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Identifier or i d s 

any valid CYBIL identifier is legal 

( I d»c I w$input_stack_a!anager ) • 

product or pd t 

(optional) file name of a local or permanent file which 
contains a list of wodule deck nai^es and/or module deck 
prefixes Clf your system has sucH a convention) which 
specify to SYSTEHX a subset of your system you wish to 
obtain a global cross reference of« If the file name 
specified is both local and pemanent* the local one is 
used* The module deck names or prefixes can be delimited 
by spaces or EOL only and can occur on multiple text lines 
In this file* Please note that the file name •FULL* has a 
special meaning and Is not examlnedt but rather a complete 
system^wide cross reference is or'oduced. This parameter 
can be used in one of two ways. It can be specified 
during the initial call to SYSTE^^ ta begin the bulld» in 
which case the build parameter was used* or in conjunction 
with the restart parameter* If It Is not specified at the 
Initial build tlsne^ the default Is to produce a complete 
system-wide cross reference. 4hen used with the restart 
parameter* permanent files CSYSX^l . .SYSX?in» SYSXPHl* and 
SYSXOKS) must already exist. These files are created 
during phasel build. All other* 'SYSX*' files must be 
purged U*e., SYSXRST, SYSXORl, SYSXDR2* SYSXSRT, SYSXHST* 
SYSXTf1P# and SYSXTXT). Cpd»prodfls) 



unused t 

TBO 



output or J 

Coptionall local file name for output from a SYSTEMX 
query. If the default (SYSXO'JT) Is used* it is rewound 
before output* For any other file na-we* the output is 
appended to the file, (o^outfife) 



qual# i 



(optional) positive integer $Y$TF»ix uses to uniquely 
qualify an identifier which is defined more than once In 
your system* When querying SYSTEMX about an Identifier 
the first time* skip the qualf oar'ameter and if the 
identifier is multiply defined* SYSTEMX will return enough 
Information so you can retry the query using the qualf 
parameter* (qual#«3) 
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deck 3 

any valid MAOIEY deck name is iegnf* f deck^clm isfa) 

build i 

l££l parameter tells SYSTEMX to bagln the build process 
from scratch. Cbyild) 

bases or ba • 

(optional) parameter default is to use the basename 'aASE* 
with the username of the current user. This parameter may 
be coded as a multi-valued list if subHsts* Each element 
of the value list Is either a sf^^gle lamef in which case 
it Is the name of a base in the current user's catalogt or 
the element is a subfist where the last subeiement in the 
sub list Is a username In whose catalog the bases referred 
to by the preceding subelements in that sublist may be 
found. Please note that a search order to MADIEY is 
implied when using this parameter'. That order is from 
left to right. Cba* <<sesllbd» ses)# (pscompi ^bui I d)^ 
(oslpi f intl}» ( pascron* pcgsrc8»pf as r'cf I oBH 1 

packnan or pn : 

(optional) default for this parameter Is to use the 
current user's permanent file device for the permanent 
files SYSTEMX creates. For large systems* enough mass 
storage may not be available on the user's permanent file 
device* in which case two auxiliary devices can be 
specified (only two). This oar'ameter' is only used at 
initial build time or with a restarl: where the product 
parameter was also specified. This paraieter may be coded 
as a multi-valued list of sublists. Each element of the 
value list Is a sublist where the last subelement In the 
sublist is the device type of the orecedlng packnanes in 
that sublist. (pii»( ( nvel»nve2>dl 1 )) or 

pn»((nvel»djl)*(nve2#dll))) 

modules or md : 

(optional) number of modules to process during phase3 
build before voluntarily shutting down pending a 
subsequent restart. The range can be from 1 to 99999. 
The default is 100 moduli^s or* the last modules 
specification Input by the user. (md«40) 



restart 



this |S5^ tells SYSTEMX to restart the build process. If 
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unused 



unused 



the product parameter Is also specif led# the build process 
is restarted frois the beginning of phase;?? othernisef the 
build process Is continued froi wherever It left off# 
When restart is specif I edf the bases and pacfcnan 
parameters are disregarded* (restart J 



TBO 



T8D 



phl> ph2# ph3f ph4 s 

(optional) lifix telling SYSTEHX i^hen to shut down pending a 
subsequent restart* phi corresP3?^ds to phasel and so on* 
The default is ph4 (which means do the whole thing)* 
Users are strongly encouraged to always use this parameter 
and step the build up one phase at a time* If a permanent 
file •DAYFILE* doesn't appear In your catalog giving you 
the last 100 lines of the job's layfi Is In the case of an 
abort* you can assume that the last build step attempted 
completed properly* 



fiche 



this Ksi tells SYSTEMX to begin writing the data base to 
microfiche formatted tape* If file SfSXFCH exists in your 
catalog* this kjBX tells SYSTEHX to restart this process 
where it left off* and the sysnane* sysverslon* syslevel 
and vsn parameters are disregarded* Cflchel 



entries i 

(optional) number of entries to or'ocess luring production 
of the fiche tape(s) before volutarlly shutting down 
pending a subsequent fiche restart. The range can be from 
1 to 99999* The default is 15*000 entries or the last 
entries specification input by the user. One entry is 
defined as a single 'deck report' or Identifier report* as 
described under the query function* ( entr I es«20*000) 



sysname 



string parameter specifies the name o^ your system and can 
be any eight characters enclosed within single quotes* 
(sysname-'NOS/VE') 
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sysverslor* 5 

(optional) string paraiaeter specifies the version of your 
system and can be any four characters enclosed within 
single quotes* Csysversl on«*l*l?» 1 



sysievet : 

Coptionall string parameter specifies the level of your 
system and can be any five characters enclosed within 
single quotes* (sysl evel «'5* ) 



vsn s 

string parameter enclosed wi thin si ngl e quotes specifies 
any legal NOS vsn to be used by SYSTEHX' when it issues a 
LABEL request for the tape required far flche processing* 

batch Job paraneters ^ 

these parameters are described In the section entitled SES 
PROCEDURES RUN AS BATCH JOBS. The default for the SYSTEHX 
build and fiche functions is to run In batctin fliode> though 
they can be run in batchy defer or focal modes as well* 
The default for the SYSTEMX query function Is to run in 
local fliode> though it can be run in batch* batchn* or 
defer modes as well* The dayflfe parameter is used by 
SYSTEMX and If the job aborts* the last lt>0 lines of the 
dayfile are dumped to your catafibg* Rfease note that use 
of the iobti parameter Is strongly encouraged 

CJobtl«77777<8n to set the time limit to unlimited. 



Examples of SYSTEMX Build Usage 

ses.systemx build ba«((nosvepl*oslpl*d5pi p1> cybl cmn* i nt2) I •• 
.•? pn>((nvelfnve2fdll}) phi jobt l«77777C8l 

This example shows the build process being initiated for the 
Advanced System* 

ses.systemx restart ph2 jobtl*»77777l8l 

This example shows a restart of the same J3b to step through phase2 
of the bul 1 d. 
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ses.systemx restart ph3 ffld«40 jobtl»77?77<8) 

This example shows a restart of the sawe Job to step through the 
first 40 fjio<ilules of processing in phase3 of the build. 

ses«systefflx restart ph3 aid«250 iobtl«77777f3l 

This example shOMS a restart of the sane job ta step through the 
next 250 modules of processing in phase3 of the build* 

Mt& * When the first text line in file »SYSXRST« says ^Pn3^ you 
know that phase3 is complete and the final phase can be started. 

ses«systeflix restart ph4 jobtl«77777f 8) 

This exafflple shows a restart of the sane Job to step through the 
final phase <phase4) of the build process. 



Exaiiples of SYSTENX Fiche Usage 

ses«systeiiix fiche entr l€s»20000 sysna(ne««nos/Ve* •• 

••t sysversion««l«12» syslevel»«5» vsi«*tp001» jobtl«77777C8) 

This example shows the fiche process being Initiated for the 
Advanced System. 

ses«systeRix fiche entr ies«40000 jobtl«77777C8) 

This example shows a fiche restart of the same Job to output the 
next 40f000 entries in the data base to tape. 



Examples of SYSTEHX Query Usage 

sescsystemx i d«tree.node«contents qualf«2 o«treefle 

This example shows a query of a multioly defined identifier 
tree.node. contents where the output is directed to file treefle. 

ses.systemx deckel istcmn qual#«2 
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This example shows a query of a muitiply defined deck listcnn where 
output is defaulted to SYSXOUT. 
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5.15 iCIilQ£-r-£OM£ AE£i«liMI£I*M.yEaiIi«iQyiaiIi-£lL£i 

SCOOP compares an 'old* file and a 'new' f H e* 1 i sts the changes 
that transforiB 'old* to •new'* and generates saurce code utility 
corrections. Any MAOIFY or UPDATE source fifes nay be compared. 
Parameters to SCOOP are i 

o or old s 

( opt! on a n name of the old file 4hich yon are comparing to 
the n CM file. The lines In this file will appear on the 
left side of the listing. If you don't code this 
parameter* the procedure expects a default file naiue of 
lEFT. 



n or new s 

(optional) naj»e of the nen fife. If yau don't code this 
parameter* SCOOP expects a default file name of RIGHT. 



i or list : 

(optional) output listing file generated by SCOOP. If you 
don't specify a value for this parai!ieter» It defaults to a 
file name of LISTING. 



s or short or nm or nonatch s 

(optional) lifix selecting short fists changes only 
(additions and deletions). Otherwise* lines that are 
common to both files are also listed.' errcnt restricts 
the number of changes listed. 



e or err or errs or errcnt : 

(optional) number of changes to be listed. Coding a 
nutseric value for this parameter restricts the number of 
changes to list. The default vafje Is 999999. 



so : 



pch 



(optional) iisx selects SHORT* l»3JTPilT. 



(optional) filename for punch output. This is the file 
containing MADIFY or UPDATE INSERT and DELETE directives 
needed to change the old file to the new file. This file 
will not be generated unless you specify a value for this 
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parameter. 
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6.0 LMMax^OS-liyLIi-.E££iEa-£iL£«MMlSIII£lI-^lIMi-LllMiI 



SiS supplies a comprehensive set of pracedures to manage multi 
record fi!es# using the NOS LIBEOIT jtlllty as a basis. It's 
assumed that you're fairly familiar with the Ideas of multi record 
file and LI3EDIT* The terminology that SES procedure descriptions 
of library management use are as follows 5 

LIBRARY A collection of records in a fife*^ All SES library 
management procedures use an I parameter to refer to a 
Li brary* 

MEMBER A single record In a library file* or a file containing a 
member which is added to or replaced on a library. All S€S 
library management procedures use an « parameter to refer 
to HEMBERCS). 



GROUP a collection of member (s) that occupy one record per member 

on the file. 
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iiiiiiLi^0£.lJ.l2!:^£x.iiiiiaii§alL.E]:a££ilui:£i 



GETMEMIS) GET MEHberS flat s| a library aatS a group file* The 
members appear one per logical record. 

REPHEHIS) REPIace or add HEHberS on n library. fou also use 
REPHEHCS) in a special way to create a brand new library 
from scratch* 



RE?UIIB REPIace or add members on a User' Library. 

COLLECT collect a group of mewbars onto a qrtmp file. 

CATLIB CATalog a LIBrary to display the names 9n<i the types of 

members in the library* in short fori! output. 

LISTMEM LIST MEMbers. LISTHEM generates a catalog of all the 

roembers on a library* and optionally prints every TEXT 
Biefflber from the library. 

SORTMEH SORT MEMbers in a library. The library is arranged so 

that all members of the sane type appear together. 

V/lthin each member type* the neitbers are sorted into 
alphabetical order. 

SRTULIB SoRT members in a User LIBrary. 

WIPEMEH WIPE (delete) MEMbers from a library. I 

WIPULI6 WIPe (delete) members from a User* LI8r arV • 

LIBEOIT use the LI8E0IT utility directly. 
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This section introduces the paraiReter rtaiing convention that's 
cojnmon to most of the procedures in the library management system. 

I or b name of Library on which the operations are to be 

per formed. 

iR stands for HemberCs). 

g or group narae of file upon vihich a GROUP of members are 

accumulated when adding ar replacing members on a 
library* or vihen members are extracted from a library* 
A group file contains one mefJibsr 9er logical record* 

nf or nb name of a New Library or New Btse# used in those 

procedures that perform operations that permanently 
alter a libraryf requiring that a new library be 
created* An explanation of the method used to update 
a library Is contained in a subsequent section* 
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The variables described below may be deolared In your PROFILE In 
order to establish default Information ^or the paraiieters of the 
I ibrary inanagement procedures* 

lib name of library where jaerabers are to be faund or replaced. 

liboMf) user name in whose catalog the library Is to be found. 

newllb name of new library for those procedures which update a 
library* thereby creating a new oie. The default na!»e for 
newlibis the same name as the old library. 

group used by all procedures to designate a group file* or a file 

containing one module per logical record. The default name 
for group Is group. 

sestmpl used by all of the procedures that update libraries to 
specify the temporary library file during the update 



process. The 



of the procedures that update libraries t< 
temporary library file during the update 
default name for this file Is sestmpi. 



lokiiode determines the interlocking action when updating a library. 
The lokmode variable may be set to •lOCK' (lock by default 
unless the nolock parameter Is coded on the procedure) or 
•NOiOCK' <no lock by default unless the lock parameter is 
coded on the procedure). 

intriok used by all of the procedures that update libraries or 
bases to specify the Interlock file to be used during the 
update process. The default name for the Interlock file is 
Intr lok. 

nx used by all of the procedures that uodate User LIBrarles to 

specify whether a cross reference o** entrV points is to be 
included in the library. If nx is set to any non-null 
value* the entry point cross ret'erence Is Qfljt included by 
default* otherwise It is. 
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Some of the library wanagement procedures physlcaliy alter a 
library* requiring that a new library be created. The process Is 
common to all such proceduresf and Is as follows : 

If you code both the I and nl parameterst new library Is created 
slispiy by performing the required operatlo?ts on the old library* and 
writing the nenly created library onto the file specified by the nl 
par ameter • 

If you code only the I parameter* update takes place In two 
stages* The updating operation Is perfomed and the new library 
written to a file called sestmpl CSES TeSiPor ary L I brary I • sestnipl 
Is then physically copied back over the file specified by the I 
parameter* and finally sestmpl Is purged* 

Note that If the file specified by the nT <or I If nb is omitted) 

does not already exist* a DIRECT access READ iiode file Is OEFINEd 

for the library <this* of course* can only be done If the owner of 
the library is the current user). 

Note that If anything goes wrong during an uodating run* the 
original library is always left Intact* and only the new library or 
sestiBpl Is potentially Incorrect* This means that you can recover 
by purging the new library or sestmpl and starting the run again* 
If something goes wrong ii^Xfltfi the library ^ppe^rs on sestmpl* 
original library Is intact* and sestmpl nay be ourged* whereas If 
something goes wrong 3lt§t the new library Is on sestmpl* that Is* 
during the •'rewrite*' phase of the update* it Is sestmpfl that Is 
safe* and the old library that Is wrong* In this case* you may use 
the REWRITE procedure to do the rewrite again* or alternatively* you 
may just purge the old library and then change the name of sestnpl 
to be the I Ibrary name* 
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When updating a library you can interlack the update so that only 
one user at a time can update the liferarV. Those procedures that 
update a library are set up so that if the library to be updated Is 
in another user's catalog^ the library Is Interlocked by default. 
You can override default actions by defining a Ibkfnode variable in 
your profile* or by coding a lock or nolockHsgif on the procedure* as 
shown in the diagram on the next page* 

Interlocking of a library is done via ai I nter lock f 1 1 e. Such a 
file iU5i be a fil£i£l access file Iq llsfi saiS aS5£rs SJtJliXJ 5S ii3£ 
ILkL^Ll^ l2Si£ia i4£dJi£iJ« Naturally the ifiterlock file must be a 
PUBLIC* yRITE MODE file if other users are tiksty to be using it. 
The default nawe used by the SES source code maintenance and library 
management procedures for the lock file Is Interlok* You can have 
an interlock file of any name by defining the Intrlok profile 
variable* or by coding a file name as a vaPje for the lock parameter 
on the appropriate procedures. 
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6.1 GETMEH OR GETHEHS - EXTRACT MEMBERiSI FRO^ LIBRARY 

GETMEMCSi is intended for extracting any lumber of iiie?nbers from a 
library onto a group file* with one neflber per logical record* 
Parameters to 6ETMEMCSI are : 

m or al I 3 

If you code the all keyword* GfTHEMtS) extracts Ail 
laewbers from the library specified by the I parameter. 
Otherwise* you code the m parameter as a fist of namets) 
of Hemberts) to be extracted. The fist of iBefnber<s) must 
all be of the same type C as specified by parameter 61. 
Ranges of member names may also be coded* as shown In the 
examples at the end of this description. 

g or group ? 

(optional) name of group file to receive the memberCs) 
extracted from the library. I^ you don't code the g 
parameter* GETHEHCS) uses the value of profile variable 
group* and if there*s no such variable defined* uses the 
name group for the group file. 

i or b s 

(optional) name of Library from which the memberCs) are to 
extracted. If you don't code the 1 parameter* GETHEHCS) 
either uses the value of profile variable lib* or If 
that's undefined* GETMEM<SI uses the lame lib for the name 
of the I ibr ary. 



un 



(optional) User Name in whose catalog the library 
specified by I is to be found* if it Isn't in the catalog 
of the current user* If you don't code the un parameter* 
G£TMEIi(S) uses the value of profile variable llbown* and 
if there's no such variable defined* the GET?1EM(S) uses 
the user name of the current user'. 



status or sts : 

these (optional) Isfill can be jsed for those cases where 
GETMEM(S) is being used as a building block of more 
sophisticated procedures or jobs. The status lifii causes 
the G£TME!i(S) procedure to set the MOS job control 
register EFG to the value zero If SPTMEM(S) successfully 
completed* and non zero if anythirig went wrong during the 
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run of GETMEIKSK If status Is not specif led» the 
procedure will EXIT If an error occ^jts* 

text or opi or opic or opid or rel or abs or oyl or pp or ppu or 

ul ib or cap or pr oc : 

these (optional) t&xs. specifies the type of the fsembers to 
be removed from the library* If you don't code any of 
these li£ia> GETH£?!(S) assumes the inembers are of type 
TEXT* A description of the meanings of these rather funny 
looking keys can be found In the NOS Reference Manual 
under the description of LIBEDIT.i 



Examples of GETHEHfS) Usage 

ses.getaiem format l»procMb un«lr77 text 
REVERT. END GETMEM GROUP <- PRQCLI8 

The example uses GETMEM to get one text 'flenber ca I I ed format from 
a library called procllb In the catalog of user Ir77. 

ses.getmem C txtcode»txtf orm^txthead) binary f*pr'glib un«mv73 oyl 
REVERT. END GETMEH BINARY <- PRGLIB 

This example extracts a group of ovl type records from a library 
called prglib In the catalog of user my73 and olaces them on a group 
file cal I ed binary. 

ses.getmem (conput..p Iscan^ ciilev..cilor'd) f«dbugllb rel 

REVERT. END GETMEM GROUP <- D8UGLI8 

This example illustrates how ranges may be coded for a parameter. 
The example extracts all rel members comout through piscan 
Inclusive* and all members ei I lev through cilord Inclustvef from a 
library called dbugllb* and places the extracted members on the file 
cal I ed group. 
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6.2 REPMEM OR REPMEMS - AOO OR REPLACE HE1SERC51 3^ LIBRARY 

REPHEH and REPHEMS are syf^onyms for a procedure to add new 

member <s) top or replace member <s) on a library, iaifi ^ to add or 

replace roembers on a User LIBrary* for use by the CYBER loader* use 

the REPULIB procedure described beloM. Parar^eters to REPHEHCS) 
ar € s 



m or men or mens or menber or neiibers : 

(optional) list of Hemberls) to be added to or replaced on 
the library. If you don't code the fw par'afpeterf REPMEHCS) 
assumes that all the wemberfs) to be added or replaced are 
already on a file specified by the g parameter. 



g or group : 

Coptlonal) name of a group file on which member(s) are 
accumulated as one member per locjical record. If you 
don't code the g parameter* RE^MEilS) uses the value of 
profile variable group. If there's no such profile 
variable defined* REPHEHCS) uses filename group 9S the 
group file* 



I or b 



(optional) name of Library on which the memb€r(s) are to 
be added or replaced. If you do^'t code the I parameter* 
REPMEfKS) uses the value of profile variable lib as the 
name of the library. If there's no such profile variable 
defined* REPHEfl(S) uses a library name of fib. 



nl or nb : 

(optional) name of Mew Library to be created when 
REPIiE(1(S) has completed its run. If you don't code the nl 
parameter* REPliEM(S) uses the value of profile variable 
newllb* and If there's no such orbflle variable defined* 
REPM£M(S) writes the new I i br ary iver the file specified 
by the I parameter. 



un 



(optional) User Name In whose catalog the library 
specified by l/nl is to be found* If l/nT Is not in the 
catalog of the current user. If you don't code the un 
parameter* REPHEH(S) uses the value of profile variable 
llbotin as the user name from whose catalog the library Is 
to be obtained* and if there's no such variable defined* 
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REPMEMCS) uses the cyrrent user's catilog» 



lock or fioiock : 

these (optional } parameters deteml^ia iihether the base 
update process is interlocked against si nijl taneous updates I 
coding a filename for the lock oaraieter deterwines the 
naiue of the interlock file. Interlocking is the jlsfiuii 
action Hhen the base being updated Is In another user's 
catalog. If you don't code either of the lock or nolock 
lSS^» interlocking is controlled by the lokntode profile 
variable* Refer to the introluctory sections of this 
chapter for information on the inter actions of the lokmode 
profile variable and the lock and nolock parameters* If 
you don't code a filename for the lock parameter* the 
contents of profile variable Intrlok is used as the 
interlock filename; if there's no such profile variable* 
the name intrlok is used as the lock filename. The 
interlock file liiii be in the sane catalog as the base 
being updated. If the inter lock f II e cannot be found* the 
procedure aborts* 



batch job parameters : 

These parameters are described in the section entitled 
"SES PROCEDURES RUN AS BATCH JO^S". The default for tl^is 
procedure is to run in local mode* but it can be run in 
batch mode. The dayfile paraifleter is not used by this 
procedure. 



re9 or add or addrep or repadd s 

these (optional! kfi^i specify whether you're adding and 
replacing* or just replacing. If you're floli replacing 
memberts)* you can code the rep ^^t* I^ vbu omit this liai 
altogether* REPIIEM(S) assumes that you're adding iQd 
replacing member(s) and so issues the appropriate 
directives to LIBEDIT to perform that function. 



dir or build or nodlr or nobuild • 

these (optional) JSJXS specify whether a directory Is to be 
placed at the end of the library nhen R5'*H€M(S) finishes 
its run. Coding the dir or build oatians specifies that 
you want a directory record to bs added to the library. 
If you code the nodlr or nobuild options* or if you don't 
code any of these keys* REPMEfKSr doesn't add a directory 
UMt i^ a directory already exi st s 1 1 i s uo dated. 
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flisg or nofflsg : 

these < optional) liSXE contrbl ttis generation of 
Inforroatlve messages by this procedure and are fully 
described in the section entitled ^INFIRHATIVE HESSAGES 
FROM SES PROCEDURES". 



Exawples of REPMEHCS) Jsage 

ses.repfflem (firstt seconds tfiird) I'berlcl lb» bul I d 

* FIRST -> GROUP 

* SECOND -> GROUP 

* THIRD «> GROUP 

* REPLACING/ADDING HEMBERS ON 8ERKLI8 

* LIBRARY NOW ON SESTHPL 

* NEW LIBRARY NOW ON BERKLIB 

* BERKLIB PURGED 

REVERT. END REPMEH GROUP -> BERKLIB 

This example Illustrates REPMEM used to coHi»ct three members 
onto a group file# and then place the contents of the group file on 
a library called berklib* The example sho^is sone of the informative 
messages that appear during a REPMEH run* 



ses«repfiiea Isdumnyy nl'procliby g«neMPr*oc build 
* CREATING NEW LIBRARY PROCLIB 

REVERT. END REPMEH NEWPROC -> PROCLIB 

This example illustrates how to build a new library. The i 
parameter Is coded as some "dummy" name that doesn't exist. The new 
members to be added are on a group file called newproc. The new 
library Is created^ and a directory Is added because of the build 
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6 . 3 E££yiia^r.42a.flE-E££LM£«MES£Elll-.J3i.JliE^illlllv 

REPULIB is a sped aT versi on of REPMEMCS) to add or replace 
fflemberis) on a User LIBrary* LIBEOIT CtNe basis for these library 
fflanagenient procedures) can't handle user libraries dl recti y> so 
REPULIB uses the LIBEDIT and LI8GEN utilities to perforui the process 
correctly* Parameters to REPULIB are s 

m or fliefli or mems or member or nembers : 

(optional) list of MeaberCs) to be added to or replaced on 
the library* If you don't code the m Parameter* REPULIB 
assumes that all the memberCs) to be added or replaced are 
already on a file specified by the § oara'neter* 



9 or group t 

Coptional) na?»e of a group file on which memberCs) are 

accumulated as one member per logical record. If you 

don't code the g parameter* REPULIB uses the value of 

profile variable group. If there's no such profile 

variable defined* REPULIB uses fllenaiie group as the group 
file. 



I or b s 

(optional) name of Library on which the ue?!iber(s) are to 
be added or replaced. If you doi't code the t parameter* 
REPULIB uses the value of profile variable fib as the name 
of the library. If there's no such profile variable 
defined* REPULIB uses a library naiie of Mb. 

ni or nb * 

(optional) name of New Library to be created when REPULIB 
has completed its run. If you doi't code the nl 
parameter* REPULIB uses the value of profile variable 
newllb* and if there's no such profile variable defined* 
REPULIB writes the new library over* the file specified by 
the I parameter. 



un 



(optional) User Name In whose catalog the library 
specified by l/nl is to be found* if l/nl? is not In the 
catalog of the current user. If you don't code the un 
parameter* REPULIB uses the value of profile variable 
llbown as the user name from whose catalog the library Is 
to be obtained* and if there's no such variable defined* 
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REPULI8 uses the current user's catalog* 

lock or no lock 5 

these <optlonan parameters deterinlr^e vihether the base 
update process is interlocked against simultaneous updates? 
coding a filename for the lock para^^eter determines the 
name of the interlock file. Interlocklnq is the iltfaull 
action when the base being updated is In another user's 
catalog* If you don't code either of the lock or nofock 
iSSH> interlocking is controlled by the toknode profile 
variable* Refer to the Introductory sections of this 
chapter for inforraatlon on the interactions of the lokmode 
profile variable and the lock and nolock paraiaeters* If 
you don't code a filename for the lock parameter* the 
contents of profile variable Intrlok Is used as the 
inter I ock f I lenaiuej If there's no such profile variable* 
the name Intrlok Is used as the lock fllenaaie* The 
Interlock file iMSl be in the sane catalog as the base 
being updated. If the I nter lock f i I e cannot be found* the 
procedure aborts* 

batch Job paraaeters : 

These pararneters zre described In the section entitled 
«SES PROCEDURES RUN AS BATCH i03S«* The default for this 
procedure is to run in local wodet but it can be run In 
batch mode* The dayflfe parafseter is not used by this 
procedure* 

rep or add or addrep or repadd : 

this (optionaO li£i specifies whether you're adding and 
replacing* or just replacing* If you're SQi^ replacing 
member (s) you can code the rep lisi* If you omit this lifii 
altogether* REPULIB assumes that you're adding flOiJ 
replacing memberCs} and so Issues the appropriate 
directives to LIBEOIT to perforn t^at function* 



nx t 



this (optional) lisx Indicates that when REPULIB perforras 
the LIBGEN portion of its job* that LfBGEN should not 
build a cross reference of entry points in the ULI8 
record* You can set your own default for' this parameter 
by defining the nx variable in your profile (any non-null 
value causes the cross reference to aat be built}* Refer 
to the LIBGEN documentation in the NOS reference manual* 
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msg or nomsg : 

these loptionaU M5XS contrbl the generation of 
Informative n^essages by this procedure and are fully 
described in the section entitled "INFIRHATIVE MESSAGES 
FROH SES PROCEDURES". 
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COLLECT is used In conjunction iiith Mbrary nanagement procedures 
such as REPHEHIS)* COLLECT is used to accuiulate members onto a 
group file for subse<?uent processing by REPiENCSK* LIBEDIT and so 
on« COLLECT can also be used in conjanctfoi with source text 
maintenance procedures^ to collect text modijlesf adding headers and 
COHMON lines if required. Parameters to COLLECT are ; 

m or fsem or mems or meaibef or fnembers : 

(optional) list of Hembers to be accumulated onto the 

group file. Mfiifi • if the file specified by the m 

para»fieter Is a multl record file» COLLECT ilafi^ gather ^H 

records In the file. This capability Is Q,2t available 

i^ith the c and r parameters as It Is not truly applicable 
in those cases. 



c or con or opi c : 

(optional) list of COHmon modules to be accumulated onto 
the group file. COLLECT assjies that such modules are 
straight text files* and so COLLECT Places the module name 
and COHHON line at the start of the module. 



r or f eg or opI ? 

(optional) list of REGul ar modules to be accumulated onto 
the group file. COLLECT assumes that such modules are 
straight text files* and so COLLECT ol aces the module name 
at the start of the module. 



9 or group : 

(optional) name of group file onto ^hlch the member(s) or 
module(s) are to be accumulated. If you 1on*t code the g 
parameter* COLLECT uses the value of profile variable 
group. If there's no such variable defined in your 
profile* COLLECT uses the filename grbup.i 



msg or nomsg : 

these (optional) lifiis control the generation of 
informative messages by this procedure and are fully 
described in the section entitlai "INFORHATIVE MESSAGES 
FROn SES PROCEDURES". 
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Example of COLLECT Usage 

ses«€oi lect ( dococle»dostatfeatui>»ef self » equal I g»coders 
* DOCOOE -> CODERS 



♦ 


OOSTAT 


-: 


> CODERS 


♦ 


EATUP 


-> 


CODERS 


♦ 


ELSEIF 


— : 


> CODERS 


♦ 


EQUAL 


-> 


CODERS 


REVERT. 


ENI 


\> CQLLEC 



This example of COLLECT Illustrates ho^ It Is used to accumulate 
a bunch of records onto a group file. 
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CATLI8 is used to display a list of the ?fle?«bers in a library* 

CATLIB outputs the ifiembers list in a condensed foriatf four members 

per line> shoeing only the wember names and their type* Paraweters 
to CATLIB are s 

1 or b s 

(optional} name of Library i^hlch is to have its member 
names displayed* If you don*t code the I parameter* 
CATLIB uses the value of prof i I e varl abl e lib as the nasie 
of the library* and if there's no such variable defined* 
CATLIB uses a file name of lib* 



un 



(optional) User Name in whase catalog the library 
specified by the I parameter is tx> be found* If you don't 
code the un parameter* CATLIB uses the value of profile 
variable 1 1 bOMn as the user name» and If there's no such 
variable defined* CATLIB uses the current user's catalog* 



(optional) name of file to receive the Output from CATLIB* 
If you don't code the o parameter"* CATLIB places the 
member list on file output* 

short or long s 

these (optional ) Isjexs. determine the format of the output 
from CATLIB* If you omit this oar'aneter or code the short 
ll£^* CATLIB produces Its output li the form shown in the 
example below* If you code the long lsg^> CATLIB produces 
its output in the same format as the MOS utility CATALOG* 
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Example of CATLIB Usn<is 



ses«catilb b»csiolib un«iiiv69 
CSI0LIB..ULI8 A59T0IA..REL 

CNVCASE.^REt CPYA. ••••«£! 

IAT0A64«,REL IAT0N59«.REi 

IO£BU&I..R£t IKHISC...REL 

ISYSTIH..REL MCOMP.«.,R€L 

HEXI»R««.,R£L MGET.....REL 

HGETSYN^.REL MGETTOK.«REL 

MPDTPVT*,REL MPLIST,..R£L 

HTOKCNy..REi N59TQIA#«REL 

ZIATOXC.REL ZXCTQIA..REL 

REVERT. END CATLIB CSIOLIB 



A64T9IA.. 
C59T0fA.^ 
IAT0II64.. 
ISCLMSG.W 
nCS. « «!• '«'•• 
MGETCSPl.^ 
MLQCFIL-t. 
MPUT.%^^^ 
N64TQIA.. 
CSIOLIB. W 



REL 
REL 
REL 
REL 
REL 
REL 
REL 
REL 
REL 
3RLD 



CATLIST. 
IAT0A59. 
I0E3U6.. 
ISOLSYS. 
«CSCNV.. 
MSETKCS. 
MMSG. • • • 
MSTREAM* 
PKUNRK.. 



.REL 

• REL 
.REL 
.REL 
.REL 
.REL 
.REL 
.REL 

• REL 



This example shows CATLIB output for a library csiollb in the 
catalog of user i«v&9. The meinber types are as defined In the NQS 
reference manual section on LIBEDIT. 
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6.6 l.liIi£l3^r-LliI.CflMI£I^IS-Qf-LlI£iSl 

LISTHEM performs two main functions to shon you what's in a 
library* and to get a printout of the TEXT nennbers In the library if 
necessary* LISTHEM first generates a norrnar CATAL3G which shows the 
names of all the jnewbers in the library. Lastly* LISTMEM generates 
a printout of all TEXT laerRbers in the library - you can suppress 
this if you only want the catalog without the whole library's 
contents. Paraaseters to LISTMEH are s 



I or b 



(optional) name of Library to be orboessed. If you don't 
code the b parameter* LISTME^ uses the value of profile 
variable lib as the library name* and If there's no such 
variable defined* the LISTHEM uses the default name lib* 



(optional) name of file to receive the OjtPut from LISTMEM 
places the output on some unigje file name that it 
generates* The output doesn't default to file output 
because* if you're running LISTME^ interactively* you 
probably don't want the rather* voluml nous output on the 
screen* 



{optional) User Name in whosa catalog the library 
specified by I is to be found. If you don't code the un 
parameter* LISTMEfi uses the valua of the value of profile 
variable llbown* and if there isi't such variable defined* 
LISTMEM uses the user name of the current user* 



batch Job parameters s 

These parameters are described M tt^e section entitled 
"SES PROCEDURES RUN AS BATCH JOBS"* The default for this 
procedure is to run in batch mode* but It can be run in 
local mode* The dayflle paraiieter' is not used by this 
procedure* 



un I 



print 



this (optional) parameter indicates how the output of 

LISTHEM is to be printed* For tiie print parameter you may 

code any of the parameters to orocedure PRINT* If you 

don't code the print parameter at all* LISTMEM prints one 
(1) copy of the output on the ASCII printer* 
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short 2 



if you code this I optional) lss^» LISTt^EM only generates 
the catalog output* and suppresses the listing of all the 
TEXT wembers. 



Examples of LISTHEN Usage 

ses*l istnieis print«c«3 short 

12.34. 56, SUBMIT CONPLETE. JQ8NAME IS ACULARS 
REVERT. JOB LISTMEM SUBMITTED 

This example shows LISTIiEH used to process a Hbraryt whatever 
name Is the value of Mb. Three copies af the short list ^catalog 
only) are being produced. LISTMEM is beln^i run In batchj rather 
than interactively. 

ses.fl Istmeni b«proclib o«procs prlnt«(c«2f h«* I atest /prod I b« ) 

18.12*00. SUBMIT COMPLETE. J08NAME 15 ANA^ABS 
REVERT. JOB LISTMEM SUBMITTED 

This example shows LISTMEM being run In batch to produce two full 
printouts of the catalog and all the TEXT nembsrs In the library 
procllb. The title on the listing is 'latest orbclib*. 



6-2-2 
CDC - SOFTWARE ENGINEERINGS SERVICES 

18 DecenJber 84 
SES User's Handbook REVs 4A 

6.0 lI8RARr OR MUITI RECORD FILE HANAGEME^IT USING LI8E0IT 
6.7 SORTnEH - SORT LIBRARY INTO ALPHABETICAL 0?DER 

6 . 7 SQ£IM£ll-r-.SQEI-iiIEASI-ItiIQ.AL£aia£IICiL . QEaEE 

SORTHEM rearranges a library such that all the lembers of a given 
type appear In the library together* and within each type* the 
fflefBbers are sorted into alphabetical order*.? Slatfi ' ^o sort a User 
lIBrary* for use by the CYBER loader* use the SRTULIS procedure 
described below. Parameters to SQRTHEM are s 

I or b 5 

(optional) name of Library to be sorted.^ If you don't 
code the I parameter* SORTHEH uses the value of profile 
variable lib. If there«s no such profile variable 
defined* SQRTHEM uses the name lib. 

nl or nb : 

CoptionaH name of New Library to be created at the end of 
the SQRTMEH run. If you don't code the nl parameter* 
SORTMEM uses the value of profile variable newlib. If 
there's no such profile variable defined* SORTHEH writes 
the new library on the file specified by the I parameter. 



un : 



o 1 



edtsort 



(optional) User Hame In whose catalog the library 
specified by l/nl is to be fou?id* If 1/nl is not in the 
catalog of the current user. If you don't code the un 
parameter* SORTMEM uses the value of profile variable 
llbown as the user name from whose catalog the library is 
to be obtained* and if there's no such variable defined* 
SORTMEM uses the current user's catalog. 



(optional) name of file to receive the Output of the 
programs used to run SORTMEM. If you don't code the o 
parameter* SORTMEM sets o«0* or no output. This is 
usually the desirable default* since the sort process 
generates large volumes of output.^ 



(optional) pair of filenames representing the Input and 

output files of the EOT text editor. You can use edtsort 

to EDIT the SORT output to Impose your own ordering on the 
members in the library. 
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lock or noiock : 

these (optional) parameters detarilr^s ^^hether the base 
update process is interlocked against s i miif taneous updates; 
coding a filename for the lock paraneter determines the 
nawe of the interlock file* t?>tef 1 ockl ng is the d^juli 
action when the base being updated Is In another user's 
catalog* If you don't code either af the lock or nolock 
il£^ly interlocking is controlled by the loknode profile 
variable* Refer to the IntrocfJctorV sections of this 
chapter for Information on the Intertctlofis of the lokmode 
profile variable and the lock and nolock paraineters* If 
you don't code a filename for the lock? parameter* the 
contents of profile variable Intrlok Is used as the 
interlock filename; If there's no such Profile variable* 
the name Intrlok is used as the lock filename* The 
interlock file iusl be In the saie catalcg as the base 
being updated* If the interlock file cannot be found* the 
procedure aborts* 



batch Job parameters i 

These parameters are described In the section entitled 
"SES PROCEDURES RUN AS BATCH JISS"* The default for this 
procedure is to run in local modet but it can be run in 
batch mode* The dayfile parameter is not used by this 
procedure* 



nodir or nobuild or dlr or build : 

these (optional) keys Indicate whether a directory Is to 
be placed at the end of the I I br ary when SQRTWEM has 
finished its run* If you code the nodir or nobuild !ifi^# 
SORTMEM doesn't place a directory In the library* If you 
code the dlr or build jifil* SORT^EI does p1 ace a directory 
in the library* If you don't code any of these keys* 
SQRTHEM does a build* that is* a directory is created for 
the sorted library* 



msg or nomsg : 

these (optional) kfiXi control the generation of 
informative messages by this arocedure and are fully 
described In the section entitled - "INFORMATIVE MESSAGES 
FROM SES PROCEDURES". 
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Exawples of SORTHEH Usage 

ses«sortne« l«prociib batctin 

17,52. 00« SU8HIT CQHPLETE. 40BHAME IS AOXIBEf^ 
REVERT. JOB SORTHEH SUBHITTEO 

This exafsple Illustrates SORTHEH being ruf^ as a batch job by 
coding the batch lisi. SORTHEH is belr^g used to sort the file 
proclib into order. 

ses.sortmefli l«berklib lock build 

♦ L0CKIK6 BERKlia VIA INTRiOK 

♦ BERKLIB LOCKED 

♦ GENERATING MEMBER LISTS FOR BERKLIB 

♦ SORTING HEHBER LISTS 

♦ EXTRACTING MEMBERS FROM BERKLIB 

♦ SORTING BERKLIB ONTO SESTMFL 

♦ NEW LIBRARY ON SESTMPL 

♦ NEW LIBRARY NOW ON BERKLIB 

♦ SESTMPL PURGED 

♦ BERKLIB UNLOCKED 

REVERT. END SORTMEM BERKLIB 

This example Illustrates SORTMEM run hHWq you waltt at the 
terminal. The example shows the Infariiatiye inessages output by 
SORTMEM during Its run. 
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6.8 SRTUtlB ~ SORT USER LIBRARY INTO ALPHABETICAL ORDER 

SRTULI8 is a special version of SORTHEH for sorting a User 
LIBrary into alphabetical order, LIBSDIT (the basis for ttiese 
library wanageafien t procedures) can't handle user' libraries directly* 
so SRTULI8 uses the LI8EDIT and LIBGE^ ut 11 1 tl es to perform the 
process correctly* Parameters to SRTULI8 are ? 

I or b 8 

<optionail name of Library to be sorted*' If you don't 
code the J paraaieter* SRTULIB uses the value of profile 
variable Mb* If there^s no such profile variable 
defined* SRTULIB uses the name Mb* 



nl or nb ? 

(optlonall naiae of New Library to be created at the end of 
the SRTULIB run* If you don't code the nl parameterf 
SRTULIB uses the value of pr9f i I a varl able neiilib* If 
there*s no such profile variable defined* SRTULIB writes 
the new library on the file specified by the I parameter* 



un J 



edtsart 



Coptionai) User Name In whose catalog the library 
specified by l/nl Is to be found* If l/nl is not In the 
catalog of the current user* If you don't code the un 
parameter* SRTULIB uses the value of profile variable 
llbown as the user name from whose catalog the library is 
to be obtained* and if there's no such variable defined* 
SRTULIB uses the current user's catalog. 



(optional) name of file to receive the Output of the 
programs used to run SRTULIB.? If you don't code the o 
parameter* SRTULIB sets o«0* or no output* This Is 
usually the desirable default* since the sort process 
generates large volumes of output*^ 



(optional) pair of filenames representing the input and 

output files of the EOT text editor. You can use edtsort 

to EDIT the SORT output to impose your own ordering on the 
members in the library* 
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lock or nolock t 

these (optlonaH parameters detariine vihether the base 
update process is interlocked against siinjltaneous updates; 
coding a filenaffle for the lock parameter determines the 
name of the interlock file. Interlocking Is the jJMJMli 
action when the base being updated Is In another user«s 
catalog* If you don't code either of the lock or nolock 
k&XSif Interlocking is controlled by the lok»ode profile 
variable* Refer to the introductory sections of this 
chapter for information on the interactions of the lokmode 
profile variable and the lock and nolock pararoeters* If 
^ you don't code a filename for the Ibckr pararneter# the 
contents of profile variable Intrtbk Is used as the 
interlock fllenaniej If there's no such profile variable^ 
the naee Intrlok is used as the lock filename* The 
interlock file liill fee in the sa^e catalog as the base 
being updated* If the interlock file cannot be founds the 
procedure aborts* 



batch Job paraiteters s 

These parameters are described in the section entitled 
"^SES PROCEDURES RUN AS 3ATCH JOBS"* The default for this 
procedure is to run in local modet but It can be run in 
batch mode* The dayflle parameter Is not used by this 
procedure* 



nx s 



this (optional) jisi indicates that when SRTULI8 performs 
the LIBGEN portion of its J?>bf that LIBGEN should not 
build a cross reference of entry points in the ULI8 
record. You can set your own default for this parameter 
by defining the nx variable in youroroflle (any non-null 
value causes the cross reference to aal be built)* Refer 
to the LIBGEN documentation in the NOS reference manual. 



msg or nomsg : 

these (optional) Isfi^s. control the generation of 
informative messages by this prbcedur*e and are fully 
described In the section entitled '•INFORHATIVE MESSAGES 
FRO?! SES PROCEDURES". 
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WII^EHEH is intended as a means of del feting leiaberCs) from a 

library. Hllifi • to delete aewberCsJ frbi a iiser' LIBraryf for use 

by the CYBER loader^ use the WIPULX6 procedure described beloM. 
Parameters to WIPEMEH are t 

i or b : 

(optional) naf»e of Library from vihlch weiaberis) are to be 
deleted. If you don't code the f paraaieter* MIPEMEH uses 
the value of profile variable fib as the name of the 
library. If there's no such prbfife variable defined* 
yiPEMEM uses the name lib as the ^laiRe of the library. 

ni or nb s 

(optional) naiae of New Library to be created at the end of 
the yiPEMEH run. If you don't coda the nl parameter* 
mPEHEM uses the value of profile varlabfe nenfib as the 
name of the new library* If there's no such profile 
variable defined* WIPEMEM places the new library back over 
the old library specified by the f oarameter. 



un : 



text : 



(optional) User Name in «hose catalog the library 
specified by l/nf is to be faund* if t/nl is not In the 
catalog of the current user. If you don't code the un 
parameter* WIPEMEM uses the value of profile variable 
llboitn as the user name from whose catalog the library Is 
to be obtained* and if there's no such variable defined* 
WIPEHEH uses the current user's catalog. 



(optional) list of TEXT member(s) to be deleted. 



opic or com ore: 

(optional) list of OPLC Common meiberCs) or CONmon modules 
to be deleted. 



op I or reg or r : 

(optional) list of OPL or REGul ar* nember? s ) to be deleted. 



rei 
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ovi t 



abs t 



PPU 5 



9P : 



cap • 



proc 5 



C optional) Ust of RELocatab)e bir^ary lemberCs) to be 
delete<l. 



Coptlonall list of OVerLay type leiiibertsi to be deleted. 



C opt ionail list of ASSolute type iie?nberts) to be deleted. 



(optional) list of PPU type member (s) to be deleted. 



(optional) list of P? type memberls) to be deleted. 



(optional) list of CAP type wemberCsl to be deleted. 



(optional) list of CCL (not SES) PRtJCedure member(s) to be 
del eted. 



lock or no lock : 

these (optional) parameters determine whether the base 
update process is interlocked agal nst simal taneous updates; 
coding a filename for the lock oarameter determines the 
name of the interlock file. Interlocking is the d^^auil 
action Mhen the base being updated is In another user's 
catalog. If you don't code either of the lock or nolock 
l&^lSf interlocking is controlled by the loknode profile 
variable. Refer to the Introductory sections of this 
chapter for information on the interactions of the loknode 
profile variable and the lock and nolock parameters. If 
you don't code a filename for' the lock parameter^ the 
contents of profile variable Intrlbk is used as the 
Interlock filenamei if there's lo such profile variable^ 
the name Intrlok Is used as the lock filename. The 
interlock file lUSi be in the same catalog as the base 
being updated. If the interlock file cannot be found> the 
procedure aborts. 



batch Job parameters 
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These parameters are described In the section entitled 
••SES PROCEDURES RUN AS BATCH JOSS". The default for this 
procedure Is to run In local mode* hat It can be run In 
batch mode. The dayfile parameter Is not used by this 
procedure* 



msg or nomsg * 

these (optional) iSfilS control the generation of 
Informative messages by this procedure and are fully 
described in the section entitled '•TNf=3R!1ATIVE MESSAGES 
FRQN SES PROCEDURES", 



Example of WXPENEH Usage 

ses^Mipemeai l»thlsllb» text«(heavyf users)» ret«f ast««access 

♦ OSLSTING MEMBERS FROM THISLI8 

* NEW LIBRARY ON SESTNPL 

* NEW LIBRARY NOW ON THISLIB 

♦ SESTNPL PURGED 

REVERT, END WIPEMEM THISLIB 

This example of WIPEMEH illustrates the way In tihich isultlple 
lists of riscord types may be coded* and also shows a range of record 
types coded for the ral type* 



6-30 
COC - SOFTiARE ENSINEiRING SERVICES 

18 DeceiBber 84 
SES User's Handbook REVj 4A 

6.0 LIBRARY OR HULTI RECORD FILE MANAGEMENT USING LI8E0IT 
6U0 MIPULI8 - DELETE MEM8ER«SI FROM USER LIBRARY 

WIPULIB Is a special version of WIRSME*! for deleting (wiping) 
fflewberCs) from a User LZBrary* LIBEDIT {the basis for these library 
management procedures! can't handle user* libraries directly* so 
yiRULIB uses the LIBEDIT and LI8GEN utilities ta perforia the process 
correctly* Parameters to WIPULIB are s 



I or b 



Coptionai) na«e of Library from which fRemfeerlsl are to be 
deleted* If you don»t code the I parameter* WIPULIB uses 
the value of profile variable lib as the name of the 
library* If there's no such prbflle variable defined* 
yiPULIB uses the naae Hb as the riame of the library* 



nl or nb i 

(optional) name of New Library to be created at the end of 
the MIPULI8 run* If you doi't code the nl parameter* 
WIPULIB uses the value of profile variable neMlIb as the 
name of the new library* If there's no such profile 
variable defined* WIPULIB places the newMbrary back over 
the old library specified by the 1 parameter* 



un t 



(optional} User Name In whose catalog the llbriary 
specified by l/nl is to be found* if lifnl? Is not in the 
catalog of the current user. If you don't code the un 
parameter* WIPULIB uses the value of profile variable 
llbotin as the user name from whose catalog the library is 
to be obtained* and if there's no such variable defined* 
WIPULIB uses the current user's catalog* 



mem or m or r el • 

list of memberCsl to be deleted* 



lock or nolock : 

these (optional) parameters determine whether the base 
update process Is interlocked agal nst s I mul t aneous updates; 
coding a filename for the lock parameter determines the 
name of the Interlock file* Interlocking Is the dgfaulJt 
action when the base being updated Is In another user's 
catalog* If you don't code either of the lock or nolock 
liJll# interlocking is controlled by t^e lokmode profile 
variable* Refer to the introductory sections of this 
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chapter for infornsation on the ir^teractlons of the toknode 
profile variable and the lock and fiolock paraweters. If 
yoy don't code a filename for the flick- parameter* the 
contents of profile variable Intrltik Is used as the 
Interlock filename; if there^s no such profile variable^ 
the name intrlok is used as the lock filename* The 
interlock file iiiS.1 he In the stue catalog as the base 
being updated* If the Inter lock f 11% cannot be found* the 
procedure aborts* 

batch Job paraneteris • 

These parameters are described in the section entitled 
"SES PROCEDURES RUN AS BATCH JIBS"* The default for this 
procedure Is to run In local mode* hut it can be run in 
batch Biode. The dayflle parameter Is not used by this 
procedure* 



fix 



this (optlonail |S5i Indicates that when WIPULI8 perforais 
the LI8GEN portion of Its Jobf that LIBGEN should not 
build a cross reference of entry points In the ULI8 
record* You can set your o*in default for this paraaieter 
by defining the nx variable In your* prof I I e (any non-null 
value causes the cross reference to aat^® built)* Refer 
to the LIBGEN docuiaentat I on In the NOS reference manual* 



msg or nonsg t 

these {optional) lifilS. control the generation of 
informative messages by this procedure and are fully 
described In the section entitled "INFORMATIVE MESSAGES 
FROM SES PROCEDURES". 



6-32 
COC - SOFTWARE ENGINEERING SERVICES 

18 Deceffiber 84 
Ses User's Handbook REVi 4A 

6.0 LIBRARY OR HUITI RECORD FILE NANAGEHEMT IISI^^G L18E0IT 
6,11 IIBEOIT - RUN LI8E0IT UTILITY 

6.11 ilMMI-r-EUM-Ufi£l2II-yiILiII 

LIBEOIT is intended as a means of calling f^rjS LI8E0IT utility 
directly* Although SES library wanagetent procedures use the 
LIBEDIT utility themselvesf not all the fjnctlons of LI8EDIT are 
available^ since SES procedures are oriented towards the most common 
functions. The LIBEOIT procedure gives you direct control over the 
LIBEOIT utility, but still provides all SES convenience of ATTACHing 
your files for you and so on. Parameters to LIBEOIT are J 

9 or group or I go : 

(optional) name of file containing recordlsJ to be 
inserted or replaced on the library specified by t. If 
you don*t code the g parameter, LIBEOIT uses the value of 
profile variable group, and If there's no such variable 
defined, uses the default filename group. 



I or b 



C optional) name of the old Library to be manipulated by 
LIBEOIT. If you don't code the I parameter, LIBEOIT uses 
the value of profile variable Mb as the name of the 
library, and If there's no such variable defined, LIBEOIT 
uses the default name of fib. 



nl or nb • 

Coptional) name of the Ne** Library after the LIBEOIT run. 
If you don't code the nl parameter', LIBEDIT uses the value 
of profile variable newlib, and If there's no such 
variable defined, the LIBEOIT writes the new library back 
on top of the library specified bf I. 



un : 



i : 



{optional) User Name in whose catalog the library 
specified by l/nl is to be found. If f/nl Is not in the 
catalog of the current user. If y^u don't code the un 
parameter, LIBEDIT uses the value of orofile variable 
libown as the user name from whose catalog the library Is 
to be obtained, and If there's no such variable defined, 
LIBEOIT uses the current user's catalog. 



(optional) list of character strings which represent 
LIBEDIT utility directives. Using the T oarameter, it is 
possible to perform many LIBEOIT operations using a single 
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control statement* If you don't code the i pararoeter* 
LIBEDIT assumes the directives are coding from file INRUT. 
If you code the I Raraf»eter as a slngli» narae^ LIBEDIT 
assuiaes that it's the name of a file containing LIBEDIT 
directives. 



o : 



this (optional^ parameter specifies the na^e of the file 
to receive the listing output fron LIBEDIT. If you don't 
code this parameter* LIBEDIT places its fisting output on 
file OUTPUT. 



lock or nolock i 

these (optional) parameters deteriBlne whether the base 
update process is interlocked against simultaneous updates! 
coding a filename for the lock parameter determines the 
name of the interlock file. Interlocking Is the dfilauit 
action when the base being updated Is In another user's 
catalog. If you don't code either of the lock or nolock 
kfiXS^ interlocking is controlled by the loknode profile 
variable. Refer to the Intr odiictory sections of this 
chapter for information on the Interactions of the loknode 
profile variable and the lock and nolock parameters. If 
you don't code a filename for the lock parameter* the 
contents of profile variable Intr I ok Is used as the 
interlock filename; If there's no such profile variable* 
the name Intrlok is used as the lock filename. The 
Interlock file lUSl t>« In the same catalog as the base 
being updated. If the interlock file cannot be found* the 
procedure aborts. 



msg or nonsg : 

these (optional) ilfixs. control the generation of 
informative messages by this arbcedure and are fully 
described in the section entitled "INFORflATIVE MESSAGES 
FROM SES PROCEDURES". 
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Example of LIBEDIT ilsage 



ses*libedlt l*prdglit> i'^^iyovl /cataio9*catt ist» sesmsg* 



• «••• here appears the output from LIBEOIT uti 1 1 ty 

♦ NEW LIBRARY ON SESTHPL 

^ NEW LIBRARY NOW ON PR06LXB 

* SESTHPL PURGED 

REVERT, END LIBEDIT PROGLIB 

The example illustrates how the LIBEOIT ut i 1 1 ty input directive 
may be coded as a string parameter on the procedure call line* The 
text preceded by periods indicates where* in the actual use of 
LIBEOIT* output from the LIBEDIT utility Itself apoears. 
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T.O S£IIiMi.iMfOSIiiIiQM 



ThJs chapter describes a collection of SES prbcedyres to find out 
what's going on and what's available* There are two faain areas of 
Interest s 

!• Information about your local environ^ant an 10S - what files 
you have* your validation llwits* the time* parts of your 
dayflle* and others* 

2« Information about SES - docuinentsf orocedures and status. 

CATLIST display coiaprehensi ve information about files in a user's 
catalog* 

OAYFILE displays a selected part of your cfayflle. 

CATALOG gives a condensed list of the records In a library. 

FILES display information about local files. 

PERMIT gives permission information for flies In a user's catalog. 

LIMITS displays your LIMITS information In a condensed format. 

TIME "talks" the current time as a dayfile ntessaoe. 

DISPLAY displays various information about your Job environment. 

DAYWEEK tells you what day of the week a date fell on* falls on 
(that is* today)* or will fall on. 

EXPLAIN displays online manuals. 

CONVQLM converts online manual source to ^35/VE format. 
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TOOLOOC prints documents describing toois.i 

IHFO displays the latest information tbojt SES. 

USSINFO displays the latest inforiBation about User Supplied 
Softviare* 

SESPROC generates a list of names of SBS procedures. 

SESPARM generates a printout of the paraiietar lists of SES 
procedures in any selected procedure library* 
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7.1 CATLIST - DISPLAY PERMANENT FILE INFORMATION 

1 * I £iiaiI-r-.Qii£LM-££EMM£MI.£iL£.XM£QElII101 

CATLIST gives you a concise btit very comoreheftsiye list of 

inf orwatlon about all files ifi a catalog. t The files are listed In 

alphabetical ordert three files peT line* so that you can get 45 

files worth of information on one scree?iload. The world goes by 

your window more sfowly» so to speak. for each file in the 

specified catalog* CATLIST outputs the inf orliat 1 o^i In the following 
forwat 2 

FILENAM type category wode length 
where the different things displayed are s 

FILEMAH is of course the naiae of file In question. 

type is the access type for the file. It is I for an Indirect 

file* and for a Direct file. 

category is the security of the file. This field is PU for a PUbllc 
file* SP for a Semi Private file* and PR for a PRivate 
f i le. 

mode Is the access mode for the file. This is one of R for 

Read* W for Write* !i for Hodify* A for Append* RM for Read 
Modify* and RA for Read Append and E for Execute. 

length is the length of the file In PRUS.^ 

For exawple* a typical line of outout froi» CATLIST would be 
like : 

MAILBOX I PU RA ••! MAXBIN PU R 342 PROFfLE I PR R •.! 

This line of CATLIST output shows that MAILBOX Is an Indirect 
access £Ublic ^e%d Append mode file of I pr\i9 MAXBIN Is a filrect 
access £Ubllc gead mode file of 342 prus* and PROFILE is an Indirect 
access £fiivate Bead mode file of 1 pru. 



CDC - SOFTWARE ENGINEERING SERVICES 
SES User's Handbook 



T-4 

18 December 84 
REV: 4A 



7.0 GETTING INFORMATION 

7*1 CATilST - DISPLAY PERHANENT FILE INFQR»!ATIOM 



Parameters to CATLIST are : 



un 



{optional) User Name of the (alter fiate) catalog to be 
CATLISTed* If you don't code the un parameter^ the 
current user's catalog Is CATLISTed* 



pn : 



<optionall Pack Name for files to be CATLlSTed. If you 
don't code the pn parameter^ the files on the default pack 
are CATLISTed* 



(optional) name 
CATLIST* If you 
file output* 



of file to receive the Output from 
don't code the o parameter* CATLIST uses 



fpl 



this (optional) parameter is used to tell CATLIST hoi* many 
file descriptions it should write on each line of the 
output file* If specified* the F»lfes Per Line paraineter 
must be given a numeric value from 1 to 10* If you don't 
code the fpl paraiseter* CATLIST generates 3 files per 
line* 



aatfi • CATLIST 
user's catalog* 



can only handle the first thousand files in a 



Exatnple of CATLIST Usage 

The example below sho*«s a CATLIST for another* user's catalog* 



ses* cat list un«ls69 
















CATLIST OF LS69 FOR 


LR78 I 


13 FILES* 10769 


PRUS ) 










CSIOLIB SP R .167 


CSIOPL. 


SP R .585 


DICTION 


I 


SP 


R 


.125 


DOCBASE SP R 1158 


001PL64 


SP R ..55 


092R64. 


D 


SP 


R 


.347 


D02S64* SP R .783 


INTRLOK 


PU R .*•!) 


ISOiLIB 


I 


SP 


R 


..37 


NAILBOX I SP W ...d 


PROCLIB 


D SP R .V09 


PROGLIB 


D 


SP 


R 


6126 


UTILITY D SP R .971 
















REVERT. END CATLIST 
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7.2 OAYFItE - DISPLAY SELECTED PORTIONS QF DAYFItE 

7*2 JlM£iL£.=.Dil£UX.i£L£CI£B«£QiI10MS.Q£..111I£lL£ 

OAYFILE displays either the last 14 lines of ?ojr dayflle* or to 
display any number of lines starting at a specified character 
string* Paraiaeters to OAYFILE are J 

1% or list 3 

(optional) number of lines of dayfile to display* If you 
don^t code the n parameter* DAYFILE displays 14 lines* 

find s 

(optlonall character string at vihlch tci start displaying 
the dayfile* If you don't code the find parameter* 
OAYFILE always goes to the line specified by last^liiie-n* 
If you code a character string f or* thi s par amet er * DAYFILE 
goes to the last occurrence of that character string* then 
displays n lines starting from t^at stri?>g* 

o or outpyt * 

(optionail name of file to receive the output from 
OAYFILE* If you don't code the o parameter* DAYFILE uses 
file output* 

Hfitt 5 If you code the find parameter* the ? character may not be 
a part of the character string* as ? is used as the string 
delimiter for the search* 
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7.3 CATALOG - SHOW LIST OF RECORDS IN A FILE 

CATALOG performs the NOS CATALOG operatlor^ ort a file. The NOS 
CATALOG utility outputs a large amount c»f Information about the 
records* wost of which is never used* T?^9 SES CATALOG procedure 
outputs a condensed form of the information froii CATALOG* shoeing 
only the record names and their types* CATALOG outputs its 
Information in the form : 

RECNAME TyPE RECNAME TYPE RECNAHE Tf PS RECNAHE TYPE 

four record names and their types are disofayed on one llne# so that 
if you*re using a C713) terminal* the nanes and types of sixty 
records can be displayed before the infornatioi goes off the top of 
the screen* The world goes by your window nore slowly* so to speak* 
Parameters to CATALOG are * 



I or b 



un 



name of Library or Base whose contents are to be 
CATALOGED* CATALOG is so arranged that If the file to be 
CATALOGed is local to your running job at the time the 
CATALOG runs* the file isn't RETJR^ed.t If the file Is not 
local when CATALOG runs* CATALOG SFTs or ATTACHes the file 
for you* and RETURNS It when It has been CATALOGed* 



(optionan User Name In whose catalog the file is to be 
found* if the file Is not in the catalog of the current 
user* 



o or output i 

(optional) name of file to receive the Output from 
CATALOG* If you don't code the o parameter* CATALOG uses 
f I le output* 

short or long : 

these (optional) Ms^s. determine the format of the output 
from CATALOG* If you omit this parameter or code the 
short liJBi* CATALOG produces its output In the form shown 
in the example below* If you c^de the long is£i* CATALOG 
produces Its output in the same format as the NOS utility 
CATALOG. 



See also the descriptions of procedures CATBASE and CATLIB which 
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7.0 GETTING INFORMATION 

7.3 CATALOG - SHOy LIST OF RECORDS IN 



A FT IE 



provide useful defaulting of the I and un oara»!isters* 



Example of CATALOG Usage 

This example stio*is a CATALOG operation Performed on a library 
from another user«s catalog. The CATALOG procedure obtains the 
library^ and returns it when It has finished. 



ses*catalog afiie# un«Jf73 

CCEFNGR««OPLC CE0H.....OFL 

CRACK* •••OPL EDBLO....OPL 

EPBLD«.««OPL FNTMSG...OPL 

POOTESC.OPL PUSHERR..OPL 

SFWTIL«..OPL SRCHNS6..0PL 
AFILE....OPLD 

REVERT* END CATALOG AFILE 



CEDTEKT.i.QPL 
EFNGR.*^?.OPL 
MSGDICT.1.0PL 
REP£RR*t.^QPL 
STRTIIP*.^QPL 



CIOINT...OPL 
ENVINIT**OPL 
PINESC*..QPL 
SFSKEOL**OPL 
TCS***«**OPL 
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7.4 FILES - OISPIAY LOCAL FILE INFORHATION 

FILES gfyes you a concise list of I nfor'nat lofi about your local 
files. The output of FILES is a cosipressed foffi of the output frofji 
the NOS utility ENQUIRE^F. Paraweters to ?=ILES are i 

o or output : 

(optional) specifies the name of the file to receive the 
local file Information. If you don't code this paraaieter* 
FILES uses file output. 



ail 



if you code this (optional) ls,&t* ^ILES includes in its 
output some files that are norialfy not Included because 
they are always present (e.g.* INPUT*:, INPUT* and OUTPUT). 



Exaaiple of FILES Usage 

ses.f I les 

LBSRC70 ..817 PH. UTILSRC .1447 P«* SCLEOIT ....3 LO. 

GROUP. • ...12 LO. 

REVERT. END FILES 

The example shows FILES being used to list local file Information 
to the terminal • 
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7.0 GETTING INFORHATIQN 

7.5 PERMIT - OBTAIN EULL IIST OF PERMISSION INFORMATION 

PERMIT provides you with a permission liiforiiatlan for all files 
In your catalog^ or for a selected list of files* *«hereas if you use 
the NOS CATilST utility^ you can only list oer mi ssl ons one file at a 
tlwe. Parameters to PERHIT are s 



o or 



ou 


tput i 




















I opt! onaM 


name 


of 


file 


to 


receive 


the 




If you 


don* 


't 


cc 


ide 


the 





paraneter* 




output. 



















f or fn 



Output froffl PERHIT. 
PERMIT uses file 



{optional) list of File Nai^es for* ifhiich you wish the 
permission Information to be produced. If you don't code 
the f parameter^ PERMIT gives the Iriformation f or al I 
files in your catalog. 



Exanple of PERHIT Usage 

ses«periiit fn«proclib 

CATALOG Of MRB FM/CLSH176 80^10/28. 08.56.42. 

PR0CLI8 



1. SES READ 3 80/10/17. 09.43.18. 

2. SESAUX READ 1 80/10/28. 08.44.33. 

3. SLE READ 1 80/10/28. 08*50.29. 

4. EFT READ 1 80/10/28. 03.54.58. 

This example illustrates a typical use of PERMIT, The output 
from the PERMIT procedure Is as that of the standard NOS CATLIST 
u t i I i t y . 
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7.6 LIMITS - DISPLAY VALIDATION LIMITS 



7 . 6 iiillili^r-BlSBiiiX-MiLlMIlQS-iiMlIS: 

LIMITS provides you with a condensed version of tfie display that 
you»d get by using the HOS LIMITS control stat9?^ent« The LIMITS 
control statement uses 35 lines to display the Information, By 
using this LIMITS proceduret you get that infor'satlon in five lines* 
thereby conserving space* Parameters to LIMITS are : 

o or output t 

(optional) name of file to receive the Output from LIMITS. 
If you don*t code the o par*aTieter> LIMITS places the 
display on file OUTPUT. 



Note that this LIMITS procedure formats the LIMITS data such that 
the word UNLIMITED Is represented by an asterisk (*). 



Example of LIMITS Usage 

This example shows the use of the LIMITS procedure* and the 
typical output generated by it. 

ses* I imits 

UI«612 AB«f AB«* AB«» AB«, HI**, RP«*» TL«** CM»*f NF«*, 

0B«*, FC»*# CS»*# FS«*# PA«EVENf RO'SfSTEM* PX«HALF, TT»TTY, 

TC«ASCII# iS«BATCH# MS«** DF«*# CC«*> 3F«*f CP»*f LP«*f 

EC«*» Si«*> CN«# PN«# DS«*# AW-00007777777700007557 

REVERT. END LIMITS 
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7.7 TIME - DISPLAY CURRENT TIME OF DAY 



7 . 7 Illl£.z^Qia£i AI-£yiEa£MI-Iiil£«Q£-liI 

TIHE is a quick way of finding tJ^e tiia (to the nearest five 
{!ilnutes>« The SES TIHE procedure ♦•talks" the time as a dayflle 
message* for example J 

ses«tiiiie 

REVERT. TWENTY FIVE PAST TWELVE 
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7.8 DISPLAY - DISPLAY VARIOUS USEPUL INFORMATION 

DISPLAY provides you with an easy way to ask for' the display of 
odd things such as the job control reglsterst field length* 
SMitches^ date* tiroe and so on. You can request the display of many 
things at a tiiae. The display is formatted In a **dense»» fashion* to 
iBlnimlze the number of lines of screen used. There are only two 
parameters to DISPLAY that re^iuire values* the rest are just lijais to 
Indicate what you want displayed. The two paraieters are the expr 
or e parameter* described below* and the o parameter which 
determines which file the display goes to.' The display goes to file 
output by default. Jljaj^s indicate to OIS^LAYMfhat you want to know. 
You use DISPLAY like this s 

ses.display thingly thing2» thing3» etc. 

where the ••things" are any or all of the keys described here. 

ll£3E MhMtii^SlLS.SLL3itM 

expr or e displays the value of any valid SES expression. A list 
of the arithmetic operators available for expressions is 
given in the description of the ^ATH Procedure below. A 
full description of the syntax of expressions can be 
found in the SES Procedure Wrlter^s Guide. 

date displays the current date in the fori s AUG 1* 1978 

time "talks" the time in the form ; TWENTY FIVE TO ELEVEN. 
The time given in this forn Is always rounded to the 
nearest five minutes. 

clock displays the clock time in the form * ^?23 PH 

fl displays your current Field Length 

rl displays the contents of Job cof\trb I r eg! ster Rl 

r2 displays the contents of job control register R2 

r3 displays the contents of job control regl ster R3 

rig displays the contents of job control register RIG 

ef displays the contents of the Error Flag 

efg displays the contents of the Global Error Flag 

jcr displays the contents of all four Job Control Registers* 
Rl* R2* R3 and EF. 

SM displays the six sense Switches 1 to 6 In left to right 
order . 
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7.8 DISPLAY - OISPIAY VARIOUS USEFUL INFORMATION 



all displays ALL the above i nformat I o?i 



Example of DISPLAY Usage 



ses« display all 
FL * 45000C8)» Rl » 4500# 10624(8y* R2 » 
R3 » 6789, 15205l8)f RIG « Oj EF « 3# EFG « 0# 
SM « CF,T,F,T#T»FI, JAN 25, 1980, TWENTY PAST FOUR 

REVERT, END DISPLAY 



7-14 
COC - SOFTiARE EHSINEERIN6 SERVICES 

18 Deceinber 84 
SES User's Handbook REVs 4A 

7.0 GETTING INFORMATION 

7.9 DAYMEEK - OISPIAY DAY OF THE WEEK 



OAYVJEEK is used to deterffiine what day af the week any date 
lincluding today) fell onp lS9 or wIM fall on. Parameters to 
DAYilEEK are s 



day 3 



Month : 



(optional) specifies the number o** t^e day in the month. 
If you don't code this paranieter* the current day of the 
month Is used. 



(optional) specifies the month either as a number C1..I2) 
or as a string {of which the first 3 characters are used). 
If you don't code this parameter* the current month is 
used. 



(optional) specifies the year. Mote that ail the digits 
of the year must be given. If you don't code this 
parameter* the current year is used. 



o or output : 

(optional) specifies the name of the file to receive the 
output from OAYWEEK. If you don't code this parameter* 
OAYWEEK writes Its output to file output. 



year 
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7.0 GETTING INFORHATION 

7,10 EXPLAIN - DISPLAY ONLINE MANUALS 



7.10 £X£LAIII-r-fiii£UI«aiUii£«MiyALS 

EXPLAIN Is Msed to access the I nf ormati on avai I abl e In SES and 
NOS online aianuats. If access is re<iuested to a manual that does 
not exist at your slte# the following message will be issued^ 

COULD NOT FIND A HANUAL NAMED <nanuaf .name> 

The parameters to EXPLAIN are: 



m I 



{optional} naffle of the online wanuaf to be accessed. If 
you don't code the wanual parameter* EXPLAIN uses the 
default online iiaanual menu named 5ESINF0» which allows you 
to access the available online i^anuafs by menu selection. 
The values that can currently be yised on the inanual 
parameter are: 



SESINFQ 
TOOLS* SES 
CYBIL 
MISC 

GRAPH, CADSG 
DEFINE, DO, CADSOD 

CID 

COMMAND 
CONTEXT 
FTN5, FORTRAN 
SORTS, SORT 



Qnl Ine Manual Menu 

SES Users Handbook Online Manual 

CYBIL Online Reference Manual 

Miscellaneous Routines Interface Reference 

Manual 

NOS GRAPH Graphics Online Users Handbook 

NOS DEFINE Data Dictionary Tools Online 

Users Handbook 

Cyber Interactive Debug Online Manual 

NOS COMMAND Online Reference Manual 

Online Manual Reference Manual 

FORTRAN Version 5 Online Reference Manual 

SORT/MERGE Version 5 Online Reference 

Manual 



topic or t : 

(optional) string to be used in ari index topic search of 
the named online manual. The online manual will be 
entered at the screen pointed to by the Index topic given 
in this parameter, rather than at the main menu of the 
online manual. This parameter must be specified in the 
form of a string, for example, t=«this Index topic*. 



Examples of EXPLAIN Usage 



ses.explain 
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7*10 EX9LklH - OISPIAY ONLINE MANUAtS 

REVERT* END EX{»LAIN 

ses«expi aid cybi I 

REVERT, END EXPLAIN CYBIt 

ses«explain ni«ftr)5 
REVERT, END EXPLAIN FTN5 
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7.11 COHVOiH - CONVERT ONLINE MANtJAl SOURCE TO NOS/VEFORNAT 

7.11 £QMQLM.r-£QMl£ai«aililMI-.aiMy^i-SayS!IS:.I2-!i21/¥l^£QSaiI 

CONVOLH is use4 to convert NOS on I i fie nnnnal source files to 
NOS/VE format. The converted online itanuaf source file fflust be 
raoved to NOS/VE by the user. The paraiRetsrs to CO^IVOLM are 5 

Input or I or f s 

name of the NOS online manual source Input file to be 
converted to NOS/VE format. 



output or o : 

(optional) name of the output file ^^filch will receive the 

converted online manual source file. If the output 

parameter is not coded# the output aooears on the file 
specified by the input parameter. 

I i sting or I : 

(optional) name of the listing file «hich will contain the 

error and statistics messages created during the 

conversion. If the listing parameter Is not coded* the 
error/statistics output appears on a file called LISTING. 



Examples of CONVOLM Usage 



ses.convoim i«nosRans 

REVERT. END CONVOLM NQSWANS -> NQSNANSt LISTING 

ses.convolfli nosnans vesans 

REVERT. END CONVOLM NOSMANS -> VEMANSf LISTING 

ses«convolii i«nosiiians o«veiiians l«stats 
REVERT. END CONVOLM NOSMANS -> VEMANSfSTATS 
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7.12 TOQLOOC " PRINT TOOL DOCUNENT 

7.12 IOflLfia£^=-£EliI-iaflL^aQQya£liI 

TOOLDOC Is the jneans by wtiicb on-line and/br of f- f i ne copies of 
TOOL OOCuients are wade available. Parajneters to TOOLOOC are s 



docs or d : 

This {optional) parameter Is used to indicate which 
document (s) you wish to obtain. Document names are taken 
from the "document number" coftimn of the document index 
display Csee the *doclist« parameter*!. The absence of this 
parameter will default the prac to rJisplay the entire 
document Index. 

doclist or dl : 

(optional) used to indicate that the document index is to 
be displayed - or retained on a file named by the Misting* 
parameter. The * doclist* parameter Is Ignored If the 
«docs« parameter Is specified. Specific portions of the 
document index are displayed by using the following keys 
with this parameter: 

CYBIL Compiler related documents. 

CADS related documents. 

SCU related documents. 

SES Development and Supoort tools. 

C180 Operating System developnent documents. 

Motorola 68000 related documents. 

Documents that don't fit Into the categories 

above. 

Documents available only at the local user's site. 

All of the above categories. This Is the default 

if none of the above keys are Indicated. 



listing or I : 

(optional) name of file to receive the ilflCUlfiBl ifliifil 
lliJSt&iai (when using TOOLDOC without specifying any 
document Cs )) » ac. the formatted documentCs) themselves. If 
you code the listing parameter to direct the document(s) or 
the document Index to a local fll5e> that file is not 
pr Inted. 



CYBIt 


CADS 


SCU 


C170 


C180 


M6 8000 


OTHER 


SITE 


ALL 



bin 



(optional) iil^ number used at sites requiring bin numbers 
to Indicate the bin number the outout Is to go to. If you 
don't code the bin parameter* TlOLDOC uses the value of 
profile variable userbin* and if there's lo such variable 
defined* generates a bin number of HO-10. 
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7.12 TOOLOOC - PRINT TOOt DOCUMENT 



Note that the standard SES batch job par'a?!ieters are available* 
The default is to run the job In batch mode* 



Exaiipie of TOOLOOC Usage 

ses«tooldoc arhl737 

10.36.10. SUBMIT COHPLETE. JOBNAME IS AAE9AXA 

REVERT. JOB TOOLOOC SUBHITTEO 

This exaiaple would cause the ERS for TXTFORH to be printed on the 
systew line printer* 

ses.tooidoc l«doclist local 

* INDEX DISPLAY -> DOCLIST 
REVERT. TOOLDOC DISPLAY COMPLETED 

This exaaple copies the document index to the file DOCLIST. 
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7.13 INFO - ACCESS SES IHFORHATION 



7.13 IM£Q-z^^aC£lS-.MS«I!i£a£MAIia!i 

INFO is a means whereby users aiay get up to the fnffiute bulletins 
on changes in SES« Par aaieter Is) to IMFO are s 

o or output i 

(optional) naise of file to receive the Output from INFO» 
If you don't code the o parameter'f INFO outputs the INFO 
file to OUTPUT. 
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7.14 USSINFO « ACCESS USS INFORMATION 



7.14 Uliiif Q«r«A£££SS.yil-IM£OEMIlQM 



USSIHFO is a neans whereby users liay get up 
bulletins on changes in User Supplied Softviare. 
USSIMFO are J 



to the minute 
ParaffletertsI to 



o or output J 

Coptional) name of file to receive the output from USSINFO. 
If you don't code the o paraneter* USSINFO outputs the 
USSINFO file to OUTPUT. 
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7.15 SESPROC - LIST SES PROCEDURE HAHES 



7.15 5i£i£aa£.-=-USI-i£i-.£ £i££llUE£-!iia£S 



SESPROC dispiays a list of procedure nanes altetdy used by SES» 
This is of use if you are a procedure writer arid ^i sh to create new 
procedures for use in SES* You can then use SESPR1C to ensure that 
there isn't any name conflict* Parameters to SESPROC are i 



un 



(optional) list of user names ^>iose catalogs are to be 
searched for procedure libraries* SES uses the SES 
Library NAHe as the naiRe of the procedure library to look 
for* If you don't code the un oar ajaeter* SESPROC displays 
the na»es of procedures in the SESPLIB of the current 
user* and the names of procedures an SES library. 



o or 



output : 

C opt! on al ) name 
SESPROC. If you 
file output* 



of file to receive the Output from 
don't code the o paraf«eter# SESPROC uses 



Example of SESPROC Usage 



ses.sesproc un«ed73 
UN « ED73 

CETGEN COLLDOC 
ICGEN NOVOOC HOVSUB 

RELSUB REPOOC REPSUB 

REVERT* END SESPROC 



COLLSUB 

PERT 

SENOKC 



EOTDtIC 
PRTD3C 
WIPE03C 



E0TM9O^ 

PRTSIIB 

WIPEStIB 



EOTSOB 
REIOOC 



This example shows SESPROC used to deteriiine 
procedures in the SESPLI3 of user ed73* 



the names of SES 
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7.0 GETTING INFORMATION 

7.16 SESPARM - PRINT PARAMETER REQUIREME^IfS FO?? SES PROCS 

SESPARH prints out the paraifieter definitions for all the 
procedures on a library. It runs batch 3r local with batch as the 
default* Parameters to SESPARH are s 



I 1 



un 



name of Library whose parameters are to be printed. 



(optional) User Name where the library Is to be found. If 
you don't code the un pararoeter* SESPARM assumes that the 
library Is in the catalog of the currant user. 

o or output or listing t 

{optional) name of file to receive the Output of SESPARM. 
If you don't code the o pararoeterV the output appears on 
file LISTING. 



batch Job parameters i 

These parameters are described In the section entitled 
"SES PROCEDURES RUN AS BATCH 403S«, The default for this 
procedure is to run In batchn modet but It can be run in 
local mode. The dayfile parameter is not used by this 
procedure. 

print s 

(optional) parameter to control the PRINT! ng of the 
output. When the job runs in batch* one copy is printd 
automatically. If you run the procedure In local modef no 
copies are printed^ unless you specifically code some 
print parameter. For example* y9J could code prlnt«c«3 to 
obtain three copies of the paraneter listing. The format 
of the print parameter is that of the parameters for the 
PRINT procedure. 

dfltiS that the parameter list of each procedure lusi terminate 

with a PARMENO directive* or> for those records In a library which 

don't have a PARMENO directive by virtue of the fact that they're 

INCLUDE files* the parameter list must be terminated by a 

« \ PARMEND •• 
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7,0 GETTING INFORHATIOH 

7.16 SESPARM - PRINT PARAMETER REQUIREHENTS FOR SES PROCS 



Example of SESPARN Usage 



ses.sesparm i«proclib un»hk77 local nopri?) 


DEBUG 








\ PARH KEY 


« Iff 




NVALS » 


\ PAR« KEY 


* l«args«# 


«aM 


NVAIS « 


\ PARM KEY 


. tpf 




NVALS « 


\ PARH KEY 


« t i • 




NVALS « 


V PARH KEY 


» fef 




NVALS * 


\ PARM KEY 


» 'xia* 




NVALS * 


\ PARMENO 








a«sai«3S««s 








0BU6FTN 








\ PARH KEY « 


(111, ffij 


HVALS 


« 1 NAH 


\ PARM KEY » 


1 1 i 


NVALS 


« 1 STR 


\ PARM KEY * 


»b« 


NVAIS 


« 1 STR 


\ PARM KEY « 


t|0» 


HVAIS 


« 1 NAH 


\ PARMEND 








REVERT. END 


SESPARM PR0CLI8/HK77 -> 



l^f.HAXVALS NAN 

I STR 

l.^HAXVALS NAM 

I NAM 

l.^MAXVALS STR 

lV.f1AXVALS STR 



Although this Is a rather contrived 
library with only two procedures in it* 
that SESPARM generates. SESPARM Is run in 
*#ait:> to produce the parameter definitions 



example of a 
It Illustrates 
local mod e> or 
for procedures 



procedure 
the output 
Mhi I e you 
In I i brar y 



proclib in the catalog of user hk77» 
printing of the generated output* 



T>ie noprint ti£x inhibits 



The diagram on the next page shows the alternative forms of 
parameter definitions of SES procedures. Alterr^atlve forms are 
arranged in the vertical columns. The blosics of text below provide 
a brief description of each field of a parameter definition. 
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7*0 GETTING INFORHATIQN 

7.16 SESPARM - PRINT PARAMETER REQUIREHEMTS FOR SES PROCS 



\ PARH KEY 
\ __/ \_. 



NAN 
NUN 
l«Kl«#«K2«f..«KI»l NVALS « f»lri%t,iiax STR REQ RN6 
keytford injinber F6N 

•••—.— -«-«.-—/ v^ «-:.:-.^,«,.-.u/ ^-/ X-/ x*/ 



This coffimanti starts 
the definition of an 
SBS PARaNeter* 



KEY specifies the key- 
Mord or keywords that 
may be used ithen coding 
a parameter for an SES 
procedure* 



NVALS speci 
that may be 
form min««m 
of "min* vat 
values may b 
is specified 
max are the 
value of zer 
that there 
that the par 
option key* 
indicates th 
as an opt! 
values* 



fies the 
coded for 
ax indica 
ues» and a 
e coded* 
f it means 

same* If 
o coif t 

may be no 

ameter key 

NVALS s 

at the key 

on# or th 



Number 
a par am 
tes tha 

maxlmu 
If only 

that t 

HVALS 
hen it 

values 
Mord is 
pecif ie 
iford ma 
at it m 



* of 
eter 
t a 
1 of 
one 
he m 
soec 
i n 

cod 

use 
d as 

y b 
ay b 



VALues 

* The 

mini mum 

••max" 

number 
in and 
if i es a 
dicates 
edf and 
d as an 

0*-*max 
t used 
e given 



This field indicates the parameter type* It may 
be NAHe» NUNber^ STRIng* or ForeiGN text* Refer 
to the INTRODUCTION section for a description of 
parameter types* 



< ♦ 



If this field Is coded 
descriptiont It indicates 
REQulredf and therefore may 



in the parameter 
that that parameter Is 
not be omitted*! 



If this field is coded in 
descriptlont then it indicates 
valuefs) may be coded as a RaNGe» 
form first** last 



the parameter 

that par*ameter 

that is> in the 
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8*0 FIIESPACE MANASEHENT 



8.0 £IL£a£i££.!iMMIMIiI 



SES provides sowe useful utilities to aid you In handling your 
fll *s. The procedures described here are t 



RETAIN GETs or ATTACHes all your fl las to stop them being 
archived* 



DUMPPF 

LOAOPF interfaces to a dump and load utility to provide easy to 
use dumping and loading of files. 

REWRITE provides a *»safe*» way to rewrite a file after It has been 
modif i ed* 
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8.0 FILESPACE MAMAGEHENT 

8.1 RETAIN - ACCESS All FIIES IN US€R«S CATAIOS 

RETAIN GETS or ATTACHes all your fites ta ensura tt^at they aren't 
archived. RETAIN also provides the ^acMfty to CATAIOG either 
designated files* or all DIRECT access files In your catalog. 
Paraaieters to RETAIN are s 



batch Job paraaietefs i 

These paraioeters are described in the section entitled 
»«SES PROCEDURES RUN AS BATCH JOBS»». RETAIN runs in batchn 
mode by default* RETAIN doesn't use the dayfile 

par amet er • 



c or noprint i 

{optional} coding c alone as a tia^ causes all DIRECT 

access files in the catalog t» be CATALQGed. Coding a 

list of files for c causes only those soeclfied files to 

be CATAlOGed. Coding the noprint jisi suppresses all 
output from RETAIN. 



s or short s 

coding the (optional) short Iisi directs RETAIN to generate 
a short SES style CATIIST output Instead of the NOS long 
form CATIIST. RETAIN generates the mS style long form 
CATIIST by default. 
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3*0 FUESPACE MANAGEMENT 

8.2 OUMPPF / IQAOPF - DUMP / LOAD PERMANENT ^ILES 

OUMPPF and iOAOPF provide an easy way of dufflping fifes to 
magnetic tape and retrieving thero when required* OOMPPF and tOAOPF 
use the sajne parameters* so they are described here together with 
variations explained as required* 

Note that OUMPPF and LOAOPF Interface to the permanent file 
utility RECLAIM* The parameters described below are a minimal 
subset of RECLAIM'S capabilities that are needed to dump and load 
perisanent files* RECLAIM creates and uses a database in the user's 
catalog? therefore* a direct access fife by the nanie of RECL08 
should not be purged* 

f or fi f e or f I les $ 

(optional) list of files to be pr'ocessed* If you don*t 
give any file names* all files (or fifes detersfiined by 
other selection criteria) are duiped or loaded* LOAOPF 
will not overwrite an existing fife by the same permanent 
file naifie* Therefore* if overwriting is desired* those 
files should be purged beforehand. 

tape or vsn : 

the VSN (volume serial number) of the tape that is to be 
used for dumping or loading* If the taoe VSN is already 
present in file RECLOS* it may not be necessary to specify 
this parameter* 

seven or sit or nine or nt : 

(optional) indicates whether to use seven or nine track 

tape* The default Is to use nine track* This parameter 

may be specified in the profile by the variable tapetrk* 

dn or density : 

(optional) tape density to be used.- Densities may be LQ* 
HI and HY (default) for seven track tapes and HD* PE 
(default) and GE for nine track* This parameter may be 
specified in the profile by the variable tapeden* 

ffflt or format J 

(optional) tape format to use* The default Is I which is 
NQS Internal* This parameter nay be specified in the 
profile by the variable tapefmt* 



8-4 
COC - SOFTWARE ENGINEERING SERVICES 

18 Oecepber 84 
SiS User's Handbook REVi 4A 

8,0 FliESPACE HAKAGEMEHT 

3«2 OUMPPF / iOAOPF - DUMP / LOAD PERMANENT FILES 



tape! 1st t 

coding this Copt ion a 11 ^st will cause a listing to be 
produced that shows what files are on ttie tape* It also 
gives other inforiaation such as file type* length* date 
last modified* etc* 



ty or type s 

(optional) IX££ of files to process. If you don't code the 
type parameter* all files will be processed (both direct 

and Indirect)* Other options are TY*I Cto process only 

indirect files) or TY»D (to process only IJirect files)* 

The OUMPPF/LOAOPF procedure doesn't check the validity of 
any options you code here* 



io i 



this (optional) \i&^ directs the L3ADP?= procedure to load 
files as local files only* This oaraneter' may not be used 
when dumping files* 



na or noabort : 

this (optional) K&^ directs 9UHPPf=/L0A0PF to JfOt AIHII If 
any errors are encountered during processing* The normal 
default is to abort* 



xp : 

(optional) ei^tra farameters which are options to be passed 
to RECLAIM* You code this In the form of a character 
string* 

batch Job parameters : 

these parameters are described in the section entitled '•SES 
PROCEDURES RUN AS 8ATCH JOBS" - of the SES USER'S Handbook* 
OUMPPF/LOADPF run in batch mode by default. 
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8,0 FIIESI>ACE MANAGEHENT 

8.2 OUMPPF / lOADPF -• DUMP /LOAD PERHANEMf FILES 



Examples of DUWPPF / tOADPF Usage 

ses«dumppf ysn*backyp 

07«48,35. SUBHIT COHPLETE. J08MAME IS ASRI8US 
REVERT, JOB DUMPI^F SUBHITTEO 

This is the simplest example of OUMPPF ijsagef your entire catalog 
Is dumped to nine track tape backup* 

ses«duiRppf <Mi lson»heath«nixonf agneiil» tape»abel23f d«hy 

19*17»15* SUBHIT COHPLETE. JOBNAME IS A8XfCUB 
REVERT. JOB DUHPPF SUBMITTED 

In this example^ the four files In the parenthesised list ^r e 
dumped to tape A8C123 where the tape density (the d paraweter) Is 
set to NY C800 bp I ) Instead of the default PS C160D bpi). 

ses«loadpf tape«backup 

16,42.55, SUBHIT COHPIETE. JQBNAME IS AORQBIf 
REVERT, JOB LQADPF SUBMITTED 

This example loads all files from tape BACKUP. Note that 
existing permanent files are skipped during the load of files from 
tape BACKUP. 
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8.0 FILESPACE HANAGEHENT 
8*3 REWRITE - REWRITE FILE 

8.3 ££M£iI£«z«E£MaiI£-£iL£ 

REWRITE is roainly used as a building block for the source text 
maintenance and library management procedjr est wNere rewriting of a 
base or library Is required. REWRITE Is a '•safe" way of performing 
the overwrite process. If for sofse reason? REWRITE falls to perform 
the rewrite* it tries five C5) times before it gives up. Parameters 
to REWRITE are : 



I or rewritl s 

name of Input file to REWRITE. 



o or reMrlto s 

name of Output file after the REWRITE process Is complete. 
This is the new file created by the rewrite. 



un or rewritu s 

Copttonai} User Name in whose catalog the fife specified 
by o is to be found* if It Isn't In the catalog of the 
current user. If you don*t code the un parameter* REWRITE 
uses the user name of the current user*. 



status or sts s 

these {optional) ^.gis can be used for those cases where 
REWRITE Is being used as a building block of more 
sophisticated procedures or jobs. The status iifii causes 
the REWRITE procedure to set the ^^0S job control register 
EFG to the value zero if REWRITE Is successfully 
completed* and non zero If anything went wrong during the 
run of REWRITE. If status Is not spec I f I ed* the procedure 
will EXIT If an error occurs. 



msg or nomsg • 

these (optional) Isfilfi control the generation of 
informative messages by this procedure and are fully 
described In the section entitled ••IMFIRNATIVE MESSAGES 
FROM SES PROCEOURES". 



&lftl£ * l^ the new file (given by the o oaraieter) Is an existing 
INDIRECT access file* It is REPLACEd. If the new file is an 
existing DIRECT access file* REWRITE perffjriis an overwrite process 
by ATTACHing the file in WRITE mode. If the new file doesn't exist* 
REWRITE DEFINES the new file as a DIRECT access READ mode file 
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8.0 FILESPACE HANAGEMEHT 
8,3 REWRITE - REWRITE FILE 



{this* of course* can only be done If the iin parameter is omitted or 
Is given as tlie user name of the current user). 
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9.0 COHPItING, LINKING^ AND DEBUGGING 



9,0 £iM£iLIIiSi..UMllIM5ia!i2-0£IlliSIi£ 



This section describes the SES procedures available for compiling 

(assembtlng) prograps written in varloys languages* and for linking 

relocatables into executable form. The orbcedures currently 

available in this category are : 

CYBIt run the CY8IL compiler* 

CY8IL run the CY8IL compiler. 

IStfL run the ISML CC compiler. 

SYMPL run the SYHPt conipller. 

FTM run the EorTraN extended coialler.f 

FTN5 run the ForTraN-5 compiler. 

CQB0L5 run the C080L5 compiler. 

COHPASS run the CPU/PPU Assembler for the CYBER 170. 

ASM180 run the 180 ASseMbler for the CYBER 170. 

CPAS180 run the CPu Assembler for the CYBER 180. 

PPAS180 run the PPu Assembler for the CY3ER 180. 

IINK170 link relocatable binaries to forn an absolute program. 

XREFHAP generate a cross-reference fr*0T» a load map. 

GETCCDB gets the CY8IL CC Interactive Debugger ready for use. 
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GETLIBCSI get CY8IL run time library 1oc?3f to tHe Job 

CYBENV run the CY8IL environment* 
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9.0 COMPiiING* LIHKIHGf AND DEBUGGING 
9«1 CYBIi - RUN CYBIi COHPIIER 

CYBII runs the compiler for the CDC CYBER IMPLEMENTATION 
LANGUAGE. The CC compiler is available ta generate code to be run 
on a CYBER 170 machine. The CI cofjipiler Is aval I able to generate 
code to be run on a CYBER 180 machine. The C^ co«!»plfef is available 
to generate code to be run on a Notorola 6B000 ni cr'oprocessor. The 
CP cojRpiler Is available to generate UCSO ocode.^ fhe CS compiler is 
available to generate code to be run on a CYBER ^00 machine. 

The procedure is arranged so that It doas not abort. If there 
are any compi le-time errors detected* the NOS Job Control Register 
called EFG is set to a non-zero value. This feature Is used when 
this procedure Is being used as a building blockf to determine what 
steps should be taken subsequent to running the conpiler* 

Parameters to the CY8IL procedure are ? 

i or f : 

Coptional) name of Input File tti be compiled. If you 
don't code the i parameter* CY3IL assuiies that the input 
is on a file called conplle. 



(optional) name of file to receive the Listing from the 
compiler. If you don't code the I otrameter* the compiler 
output appears on a file called listing. This listing 
file is not rewound by the CY8IL procedure. 



b i 



(optional) name of file to receive the Binary object code 
generated by the compiler. If you don't code the b 
parameter* the binaries appear ot a file called Igo. This 
I go file is not rewound by the CYBII procedure. If you 
give a value of null to the b parameter* no binary Is 
gener ated. 



cc or ci or cm or cp or cs • 

(optional) Kfix determines the conpl I er used. By default* 
the CYBIL CC compiler Is used.? I? you code the cl key* 
the CYBIL CI compiler is used. If you code the en key* 
the CYBIL CM compiler Is used. If you code the cp key* 
the CYBIL CP compiler is used. If you code the cs key* 
the CYBIL CS compiler is used. ^latS • you can set your 
own default compiler selection in your profile by setting 
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9«0 COHPILING, IXNKIMG# AND DEBUGGING 
9.1 CYBIL - RUN CYBIL COMPILER 



a variable called cybll to this key. 

MfiJtS • this paraweter Is used tn select a version of the 
CC or CI or CM or CP or ZS compiler other than the 
standard one released via the SES» This Is done by coding 
as a value for this parameter the user name of the owner 
of the compiler you're after* For example* entering 
cc«lp3 accesses the version of tha CC conpller residing in 
the LP3 catalog* It Is necessary for the owner of such a 
compiler to use the file name CYBIIC for the CC version or 
CY8III for the CI version or CY3ILi for the CH version or 
CYBItP for the CP version or CYBItS for the CS version In 
order to allow the compiler to he accessed via this 
procedure* For the CS version* the ^fle CSTOSS must also 
be present in the owner's catalog*? 



chk or re ? 

this Coptlonal) parameter specifies the run-time checks 
the compiler Is to generate* If von code 02 for this 
parameter^ no run-time checking code Is generated* If you 
code any combination of a Ccheck for de-reference of NIL 
pointer)* t (check value ranges— range checking may add as 
much as 3 1/2 words to the generated object code for each 
range check performed) and ^ Cchack subscr I pt ranges)* the 
corresponding checking code is generated and omitted 
checking options cause the corresponding checks to be 
suppressed* If you omit the chk parameter* CYBIL 

generates all flavors of run-time checks* 



to 



this ioptional) parameter specifies the Options to be used 
when producing the Listing* Any combination of the 
following designators may be coded for this parameter s 

a specifies that a map of the source input block 
structure and stack is to be produced 

f specifies that a full listing Is to be produced 
(selectslist options S* A* and R) 

specifies that the listing should Include the generated 
object code In an assembler-like format 

s specifies that the listing of the source input file is 
to be produced 

w specifies that the listing of warning diagnostic 
messages Is to be suppressed 
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9.0 COHPIilNSf LINKIHSf AND DEBUGGING 

9.1 CYBIt - RUN CY8IL CQHPItER 



r specifies that a symbolic cross refersf^ce listing is to 
be produced 

ra specifies that a symbolic erbss reference I i sting of 
ail program entities is to be produced whether 
referenced or not 

X works in conjunction with the LISTEXT pragmat such that 
listings can be EXTernally cofitrbllied via the compiler 
call statement. 

If tl2 is specified* no listlf^g is produced. If the lo 
parameter is omitted* a listing of the source input file 
only Is produced. 



debug or d or nodebug : 

this (opttonaM parameter is used to select the debug 
options to be In effect for the coiipi I at ion. The 

available debug options are J 

sd If this option Is selected* the compiler Includes 
Symbol Table information In the object code file to 
be used by the CY8IL interactive debugger. If this 
option is not selected It Isn't possible to 
symbolically debug the modulefs) being compiled. 

fd This option produces the same tables as d«sd plus 
stylizes the generated code to provide a step 
facility i#hen using the syibollc debugger <it is only 
meaningful* currently* whei used with the CC 
compi I eri • 

ds If this option Is selected the Debugging Statements 
appearing between ?? nocomplfe ?? ^nti ?? complie t? 
pr agmats Is compiled* otherwise such statements are 
skipped by the compiler. 

If you omit this parameter or you code the nodebug Ksi* 
none of the sd* fd or ds options ar'e selected. If you 
code the debug or d iifiits feut don't code any values* 
debug*sd is used. To select combined options you can code 
debug*(sd»ds) or debug»(f d*dsl • 



pad 



coding a numeric value for this ( opt lonafi pad parameter 

generates the specified number of no-oos between machine 

instructions. This feature Is used for the P3 
dl agnosti cs . 
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9.1 CYBIl • RUN CYBIL COMPILE!? 



Opt 



this Copttonal) paraiBeter is used to select opt iiRizatlon 
levels In the generated code Cnot supported for all 
compiler Imp! ementations) • Legltlii^ate values are J 

Provides for keeping constant valiies In registers* 

1 Provides for keeping local vmr'labfes In registers. 

2 Eliminate redundant ineinory references and comaion 
subexpr essi ons« 



nsg or nomsg * 

these (optional) El£S control the generation of 
inforwative messages by this arbcedure and are fully 
described in the section entitled '•IN*=0??HATI VE MESSAGES 
FROM SES PROCEDURES". 



Exaaple of CYBIL Usige 

ses«cybH lo«»or'» chk»«sn» 

REVERT. END CYBIL COMPILE •> LISTINSf LGO 

This example shows the CYBIL CC compiler being used to process 
the program on file COMPILE. A listing Is produced consisting of 
the source input* generated object codet and a symbolic cross 
reference* on file LISTING* The object code is written to file LGO 
and will include run-time checking code for Subscript ranges and NIL 
pointer de-reference. 
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9.0 COMPILINGf LINKING, AND DEBUGGING 
9*2 ISWL - RUN ISWl CC COMPILER 



9 . 2 IiEL-.:.IUM-IiML^£i;^£QI3£lL£E 

ISWL runs the ISWL CC compiler. 

The procedure is arranged so that if there are any coapi I e-t Ime 
errors detected* the NOS Job Control Register called EFG Is set to a 
non-zero value* This feature Is used wher^ this procedure Is being 
used as a building block, to determine ^hat steps should be taken 
subsequent to running the compiler. 

Parameters to the ISWL procedure are s 

i or f 5 

(optional) nawe of Input File to he co?iipiled. If you 
don't code the i parameter, ISWL assu?nes that the Input is 
on a file called conpHe* 



(optional) name of file to receive the Listing frow the 
coriipller. If you don't code the I parameter, the compiler 
output appears on a file called listing. This listing 
file is not rewound by the ISWL procedure. 



(optional) name of file to receive the Binary object code 
generated by the co«?piler. If you don't code the b 
parameter, the binaries appear oi a file called igo. This 
I go file is not rewound by the ISWL procedure. 

lo : 

if this (optional) parameter Is specified as £, a symbolic 
cross Reference map is produced on the file specified by 
the I parameter. (R Is the only List Option available 
with this ISWL procedure.) If you don't code this 
parameter, ISWL does not produce a cross reference. 

small or medium or large • 

these (optional) Is^is are used to select the iii5 of the 
ISWL compiler to be used. As you flight have already 
guessed, three sizes are available. The default is medium 
but this can be over-ridden by defining In your profile a 
variable called iswlsiz set to 3ne of these keys. The 
compiler size determines how large a module can be 
compi I ed. 
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debug or nodebug s 

these (optional) lifixs. set ect whet her you want the cofflplter 
to generate lin the object code fTte) information for the 
ISWL OEBUGger which runs under the SES SUaSYSte?a. If you 
code the debug ksif ISWL generates the debug i nf or isation. 
If you code the nodebug Issi or if you don* t code either of 
these keys* ISWi does not generate the debug information. 



nsg or nomsg : 

these (optional) lifiXS control the generation of 
informative messages by this orbcedurle and nre fully 
described in the section entitled "INFCTRIIATIVE MESSAGES 
FRQH SES PROCEDURES^. 
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This procedure runs the SYMPl coisj>l ler ^or the CYBER 170. 

The procedure Is arranged so that If there are af^y coispi I e-tiroe 
errors detected* the NOS Job Control Register called EF6 Is set to a 
non-zero value. This feature is used when this procedure Is being 
used as a building blocks to determine «hat steps should be taken 
subsequent to running the compiler. 

Parameters to the SYMPL procedure are ? 

i or f s 

(optlonall naaie of Input File to he cowpiled. If you 
don't code the i parameter* SY1PL assumes that the Input 
Is on a file called compile. 



(optional) naroe of file to receive the Listing from the 
coinpller. If you don't code the t parameter* the compiler 
output appears on a file called listing. This listing 
file is not rewound by the SYMPL procedure. 



b : 



lo 



xp 



(optional) name of file to receive the Binary object code 
generated by the compiler. If you don*t code the b 
parameter* the binaries appear oi a file called tgo. This 
I go file is not rewound by the SYHPL procedure. 



this (optional) parameter Is used to specify the List 
Options for the compilation (see the SYMPL reference 
manual for legal list options). If you don't code this 
parameter* SYMPL uses only list option L. 



this (optional) parameter Is used to pass eXtra Parameters 
to the compiler (see the SYMPL reference manual for a list 
of allowed SYMPL control statement parameters). If you 
want to pass extra parameters* the list of them must be 
specified as a string (within single quotes). The SYMPL 
procedure does not check the validity of the parameters In 
the string. If you don't code this parameter* no extra 
parameters are passed to the comoller. 
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debug or nodebug : 

these Coptlofial) |S£XS select uNsther you want the compiler 
to generate Information for the CtQER Interactive Debugger 
(CIO>« If you code the debyg !ssk> SYHPL includes the 
debug Information in the object code flle» If you code 
the nodebug li£i or if you don't code either of these keysf 
SYMPL doesn't generate the debug I nf or^pat 1 on. 



Jisg or nowsg s 

these Copt ion ail llS^S control the generation of 
informative messages by this procedure and are fully 
described in the section entitled "INFORMATIVE HESSAGES 
FROM SES PROCEDURES**. 
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9,4 £Ili.r-EyM^IIiI.£IM.i£fl£I£iM-il«CQM£Ii£E 

This procedure runs the ETH CForTraN €xtef>dedJ coppiler for the 
CYBER 170. 

The procedure Is arranged so that If there are any cosup II e-ttpe 
errors detected* the NOS Job Control Register* cat I ed EEG Is set to a 
non-zero value* This feature is used vihei this orbcedure is being 
used as a building blocic# to determine what steps should be taken 
subsequent to running the compiler. 

Parameters to the FTN procedure are 5 

I or f : 

(optional) name of Input File to be complied. If you 
don't code the i paraiaeter* FTN assumes that the Input Is 
on a file cal led compi I e. 



(optional) name of file to receive the Listing from the 
compiler. If you don't code the I parameter^ the compiler 
output appears on a file catted listing. This listing 
file is not rewound by the FTN procedure. 



(optional) name of file to receive the Binary object code 

generated by the compiler. If you don't code the b 

parameter* the binaries appear on a file called Igo. This 
t go file Is not rewound by the FfM procedure. 



fl 



xp 



this (optional) parameter specifies the PI eld Length to be 
used while running the compiler. If you don't code this 
parameter* FTN uses a field length of 70000(8). 



this (optional) parameter Is used to pass eXtra Parameters 
to the compiler (see the FTN reference manual for a list 
of allowed FTN control statement oar aieter s ) . If you want 
to pass extra parameters* the list of them must be 
specified as a string (within single quotes). The FTN 
procedure does not check the validity of the parameters In 
the string. If you don't code this parameter* no extra 
parameters are passed to the compiler.* 
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debug or nodebug i 

these (optional) ]££is select whether you want the coi«piler 
to generate inforaiatlon for the CYBER Interactive Debugger 
CCID}« If you code the debug liglf FT^ Includes tt^e debug 
Information in the object code file. If you code the 
nodebug k&t or if you don't code either of these keys* FTN 
doesn't generate the debug information. 

ms g r n ms g : 

these Coptional) K&tS. control the generation of 
informative messages by this procedure and are fully 
described in the section entitled «I!^FORMATIVE HESSAGES 
FROM SES PROCEDURES". 
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9 • 5 tmi^z^gm^mg^iim^Ltmigmzii^^miL'E:^ 

This procedure runs the FTN5 (ForTraM-St also knoMin as 
Fortran-77) compiler for the CYBER 170* 

The procedure Is arranged so that If there are any corapi I e-t Iwe 
errors detected* the NQS Job Control Register called EFG Is set to a 
non-zero value* This feature is used when this Procedure is being 
used as a building block* to determine what steps should be taken 
subsequent to running the compiler* 

Parameters to the FTN5 procedure are i 

i or f : 

(optional) name of Input Fif^ to be coniplled* If you 
don't code the I pararaeter* FTN5 assumes that the input Is 
on a file called compile* 



(optional) naiae of file to receive the Listing from the 
compiler* If you don't code the f parameter* the compiler 
output appears on a file called listing* This listing 
file Is not rewound by the FTN5 orbcedure* 



(optional) name of file to receive the Binary object code 
generated by the compiler* l^ you don't code the b 
parameter* the binaries appear on a fife called Igo* This 
I go file is not rewound by the FTM5 procedure* 



fl 



XP ! 



this (optional) parameter specifies the Field Length to be 
used while running the compiler* If you don't code this 
parameter* FTN5 uses a field length of 70000(8)* 



this (optional) parameter is used to Pass extra Parameters 
to the compiler (see the FTN5 reference manual for a list 
of allowed FTN5 control state-nent par ameter s) • If you 
want to pass extra parameters* the list jf them must be 
specified as a string (within single quotes)* The FTN5 
procedure does not check the validity of the parameters in 
the string* If you don't code this parameter* no extra 
parameters are passed to the ccnpllsr*^ 
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debug or nodebug : 

these (optional) Jsfi^s select wfiether you ^ant the coaiplfer 
to generate Information for the CfBER Interactive Debugger 
<CID). If you code the debug Ms^> FTM5 Includes the debug 
information in the object cods file. I If you code the 
fiodebug K£J£ or If you don't code either of these keys* 
FTN5 doesn't generate the debug Information. 



ffisg or noflisg : 

these (opt I on an ISSIS. contr*ol the generation of 
informative messages by this arocedure and are fully 
described in the section entitled "INFORMATIVE MESSAGES 
FROH SES PROCEDURES". 
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9.6 £Qi§LS-«-£yM.ia£-£QiaJL5.aQM£lL£I 

This procedure runs the C080L5 compiler for the CYBER 170. 

The procedure is arranged so that if there ar% any compi 1 er-tiie 
errors detected* the NOS Job Control Register* call ed EFG is set to a 
non-zero \rafue* This feature is used when this procedure is being 
used ns a buiiding block* to determine what steps should be taken 
subsequent to running the compiler. 

Parai^eters to the C080L5 procedure are s 

I or f 2 

(optional) naiae of Input File to be C9!«piled* If you 
don*t code the i parameter* CQ81L5 assuies that the input 
is on a file called coispile* 



(optional) name of file to receive the Listing frora the 
compiler. If you don't code the f parameter » the conipller 
output appears on a file called listing*' This listing 
file is not rewound by the C08QL5 procedure. 



(optional) na?Be of file to receive the Binary object code 
generated by the compiler. If you don't code the b 
parameter* the binaries appear o'^ a file called Igo* This 
I go file is not rewound by the CrjBulL5 procedure. 



fl J 



xp 



this (optional) parameter specifies the Field Length to be 
used while running the compiler. If you don't code this 
parameter* COBOLS uses a field length of 70000(8). 



this (optional) parameter is used to aass extra parameters 
to the compiler (see the C08G15 reference manual for a 
list of allowed C0B015 control statement parameters). If 
you want to pass extra parameters, the list of them must 
be specified as a string (within single quotes). The 
COBOiS procedure does not check the validity of the 
parameters in the string. If you don't code this 
parameter* no extra parameters are passed to the compiler. 
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debug or nodebug : 

ttiese (optional) klXi select whet^^sr yoy want ttie compiler 
to generate Inf orwatf on for the C/BER Interactive Debugger 
(CID). If you code the debug litxt. *08^i5 Includes the 
debug information in the object code fHe, If you code 
the nodebug Isfi^t or if you don't code either of these keys, 
COBOiS doesn't generate the debug Information. Note - 
this is not the CQ8QL5 debug option >ihicti can be selected 
via the DB parameter* This C080L5 debug option can be 
selected by using the xp parameter*. 



Rsg or nonsg : 

these (optional) lifiXS control the generation of 
informative messages by this orocedure and are fully 
described in the section entitled »»tNFORMATIVE MESSAGES 
FROM SES PROCEDURES". 
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9 . 7 aSM£ASi-r-Eyi-IM£-£ii£4ii.4S:i£liaL£E 

COHPASS runs the CPU/PPU assembler CCONPASSI for* the CY8ER 170« 

The procedure Is arranged so that If therie are any assewbl e-t Iwe 
errors detectedf the NOS Job Control Register cal led EF6 is set to a 
non~zero value. This feature is used when this procedure is being 
used as a building block, to determine »«hat steps should be taken 
subsequent to running the assembler. 

Parameters to the COMPASS procedure are : 

lor f $ 

Coptionail na»e of Input File to be assembled. If you 
don't code the i parameter* COMPASS assumes that the input 
is on a file called conpife* 



toptionall name of file to receive the Listing frow the 
assembler. If you don't code the I parafneter, the 
assefnbler output appears on a file called listing. This 
listing file Is not rewound by the COMPASS procedure. 
(Note that the assembler's control state-nent parameter 
Is set to the same file as soecffled by the L parameter 
only when the nomsg option (see belowl is specified.) 



b : 



fl 



xp J 



(optional) name of file to receive the Binary object code 

generated by the assembler. If you don't code the b 

parameter, the binaries appear o?i a file called Igo. This 
I go file Is not rewound by the C01PASS procedure. 



this (optional) parameter specifies the Field Length to be 
used while running the assembler.! If you don't code this 
parameter, COMPASS uses a field lengt^i of 70000(8). 



this (optional) parameter is used to oass extra Parameters 
to the assembler (see the COMPASS reference manual for a 
list of allowed control statement parameters)* If you 
want to pass extra parameters, the list of them must be 
specified as a string (within single quotes). The COMPASS 
procedure does not check the validity of the parameters in 
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the string. If you don't code this pnrnmeterf no extra 
paraweters are passed to the ass en bier. 



rasg or nomsg : 

these (optional) JiJil control the generation of 
inforraatlve laessages by this procedure and are fully 
described in the section entitled «INPORMATIVE MESSAGES 
FROM SeS PROCEDURES". 
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ASH180 executes the 130 assembler on 170. This assembler shares 
a large percentage of counRon code with the one which executes in 
native node. It produced object modules s^hlch ?nay be bound* 

Parameters to the ASM180 procedure are ? 



i or Input : 

(optional) name of the Input file to be assembled. If you 
don't code the I parameter^ ASMIBO assumes that the Input 
is on a file called input. 



b or binary * 

(optional) name of the file to receive the object code 
generated by the assembler. If you don't code the b 
parameter the object code will be writtefi to a file called 
I go. This file is not rewound by the ASIIBO procedure. 



i or listing i 

(optional) name of the file to receive the Listing from 
the assembler. If you don't code the f parameter the 
assembler output appears on a **lle eatled listing. This 
file is not rewound by the ASIil8D procedjre. 



X or xref 5 

(optional) boolean parameter selecting a cross reference 
listing. If you don't code this parameter no cross 
reference listing is produced. 

c or checks s 

(optional) boolean parameter selecting whether the 
assembler checks for correct register types. If you don't 
code this parameter the checks will be performed. 

cvt or convert i 

(optional) If you don't code this parameter the file 
specified by the i parameter will be processed directly by 
the assembler. If you give only the cvt parameter name 
the file specified by the I parameter will be passed 
through a program to convert the source statements from 
the form expected by CPAS180 to the form processed by this 
assembler. If you give the cvt parameter' name and a file 
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name as its value that file nilt receive the converted 
source statements. 



st or status i 

Coptionai} If this parameter Is given a value of EFG or 
R1G» those job control registers *in I be set to zero for 
no assembly errors and non-zarb If there are assembly 
errors* 



msg or nonsg : 

These loptlonal) lifiis control the generation of 
Informative messages by this procedure and are fully 
described in the section entitled '•INFORHATIVE MESSAGES 
FROH SES PROCEDURES*'. 
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CPAS180 runs the CYBER 180 CPU assembler'.? Tfie procedure has two 
fflodes of operation 5 

1. "noriital mode" In *ihlch object code is generated from the 
source program 

2. "systext wode** In which a *'systesi text* fife is produced 
Ccontalning pr e-assewbled PROCs* etc.) that Is used later as 
input to "norfflal mode" assentblies (see the BLOSYST keyword 
P ar afH et er d es cr I b ed be 1 ow ) 

The procedure is arranged so that if there are any conipi ! e-t ime 
errors detectedf the NOS Job Control Register called EFG is set to a 
non-zero value. This feature is used when this Procedure is being 
used as a building blocks to determine what steps should be taken 
subsequent to running the assembler. 

Parameters to the C PAS 180 procedure are s 



i or f 



I i 



chk 



(optional) name of Input Fif% to be assembled. If you 
don't code the i parameter* CPAS180 assu'flss that the input 
is on a file called compile. 



(optional) name of file to receive the Listing from the 
assembler. If you don't code the I parameter* the 
assembler output appears on a file called listing. This 
listing file is not rewound by the CPAS130 procedure. 



(optional) name of file to receive the Binary object code 
generated by the assembler. If you don't code the b 
parameter* the binaries appear on a file called Igo. This 
I go file Is not rewound by the C* AS 180 procedure. 



this (optional) parameter deter^nlnes whether the assembler 
checks for correct register types nn^ instruction formats. 
If you code no for this parameter* no checking of types 
and formats is done and the asseirbler runs faster. If you 
code yes for this parameter or 1 f you oitl t the parameter* 
the assembler performs the checks.^ 
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this (optional) parafReter is used to specify the name of a 
System text file* In ••norwal mode" this parameter Is used 
to provide an alternate to the staridar*dl '•SYSTEXT'* used by 
the assembler* In the "build systen text mode*** this 
parameter specifies the name of the fill* on *«hlch the 
system text Is written (default Is SYSTEXT), 



fl 



bidsyst 



this (optional! parameter specifies tHe Field Length to be 
used while running the assembler.! I^ you don't code this 
parameter* CPAS180 uses a field fer^gth of ?0000(8K 



If you code this (optional) }ittf CPAS180 runs In the 
"Bui ID SYStem Text*' mode. If you do?i»t code this h.&Xf 
CPAS180 runs In "normal" mode* 



oisg or noiisg : 

these (optional) issis contrrjl the generation of 
informative messages by this orocedure and are fully 
described in the section entitled "TNFORHATIVE MESSAGES 
FROM SES PROCEDURES"* 
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PPAS180 runs the CYBER 180 RPU assewbler. This assembler is a 
modified version of standard CYBER 170 C0*1?>ASS so that usage of the 
two assesnblers is very simitar* 

The procedure Is arranged so that if there are any compi i e-time 
errors detected* the NOS Job Control Register called EFG is set to a 
non-zero va1ue« This feature Is used when this procedure is being 
used as a building block* to determine ^ihat steps should be taken 
subsequent to running the assembler* 

Parameters to the PPAS180 procedure are : 

I or f t 

(optional) name of Input File to be assembled* If you 
don't code the {parameter* PPASIBO assumes that the input 
Is on a file called compile* 



(optional) name of file to receive the Listing from the 
assembler* If you don't code the H parameter* the 
assembler output appears on a fll% called listing* This 
listing file Is not rewound by the PPAS180 procedure* 
(Note that the assembler's control statement parameter 
is set to the same file as specified by the L parameter 
only when the nomsg option (see below) Is specified*) 



b s 



fl 



xp 



(optional) name of file to receive the Binary object code 

generated by the assembler* I^ you don't code the b 

parameter* the binaries appear on a fife called Igo* This 
f go file is not rewound by the PPASISD procedure* 



this (optional) parameter specifies the Field Length to be 
used while running the assembler*! If you don't code this 
parameter* PPAS180 uses a field length of 70000(8)* 



this (optional) parameter is used to pass extra Parameters 
to the assembler (see the COHPASS referer^ce manual for a 
list of allowed control statement parameters)* If you 
want to pass extra parameters* the list of them must be 
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specified as a string {within singtm quotes). Tfie PPAS180 
procedure does not check the validity of the parameters in 
the string. If you don't code this parameter* no extra 
parameters are passed to the asseibfer* 



msg or nomsg : 

these {optional! kHS control the generation of 
Inforwative messages by this procedure and are fully 
described in the section entitled "INFORMATIVE MESSAGES 
FROM SES PROCEDURES". 



conv or convert 2 

these {optional) iS£X§. specify that the output binary 
object code file (specified by the tj parameter) is to be 
connected to the NOS/170 objest text format that is 
described In the £ia£E.ifl4Q£g«SiiSaEi:CELiAiiiy4L. If this 
keyword is omitted the binary object code file produced is 
In the NOS/VE object text for^at.^ 
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9,11 ilMi2il^r-iitill-£ £iOi;iIliU«IiSMi£S 

LINK170 provides an easy way to usa tfie CYBfR 170 Loader. 
Although the CYBER 170 Loader Is very tjowerfml and flexible* it 
suffers fro^ the disadvantage that you can»t talk to It 
Interactively* since it reads ahead In tha contrbl statement file* 
and that means that you can only drive It via canned sequences of 
JCL. This procedure provides a slinple to use Interface to the 
loader which allotis for most cowreon types of linking* Mhen using 
CY8IL screen formatting procedures* a « LIBRARY* I FLIB. • statement 
should precede the call to LINK170* The 9rbcsdiire Is arranged so 
that if any link errors are detected* the ^lOS Job control register 
EFG is set to a non-zero value* This alloi4S the procedure to be 
used as a building block for other procedures.* Parameters to the 
LINK170 procedure are s 



CoptionaH list of Files containing the relocatable 
binaries that you want LINKed.f If you don't code the f 
parameter* LINK170 assuines that the relocatables are on 
file igo. The f parameter may be coded as a «ultl valued 
list of sublists. Each element of the value list is 
either a single nane* In which case It refers to the nawe 
of an object code file already assigned to the job* or In 
the current user*s catalog* HL an afe?Bent Is a sublist* In 
which case* the last sub element In the sublist Is a user 
name In whose catalog the object code files referred to by 
the other sub elements of the sublist may be found. The 
example at the end of this description should (with luck) 
make this clear. Note that files for which a user name Is 
specified are returned when the link Is co?!ipleted. 



b 3 



(optional) name of file to receive the LINKed program. If 
you don't the b parameter* LI^<170 olaces the linked 
program on file Igob. 



(optional) list of library fifes from which external 
references are to be satisfied. The o parameter may be 
coded as a mult I valued list of sublists. Each element of 
the value list is either a single name* In which case it 
refers to the name of an user library already assigned to 
the job* or in the current user's catalog* 2L ^^ element 
is a sublist* in which case* the last sub element in the 
subl i st is a user name in whose catalog the libraries 
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referred to by the other sub efeuents of the subflst may 
be found* The example at the end of this description 
should (with luck) make this clear* Note that libraries 
for which a user name is specified are returned when the 



io 



ep 



xld 



debug 



I ink Is coflipl eted* 



Coptional) n^me of file to receive the mnp Listing from 
LINK170* If you don't code the f oarameter* the loader 
uses the default map file name (?^oriariy output)* 



(optional) List Options for the LISKITO Process* If you 
don't code the Io parameter^ the loader uses Its default 
list options* If you simply code Io without any values 
supplied, LINK170 sets default values lo«sb* If you code 
io«full, LINK170 turns on FULL list options (which are 
io»sbex}* Otherwise, LINK170 ssts whatever I ist options 
you say* 



(optional) specifies a list of Entry Points to be included 
In the header of a multiple entry oo I nt "over lay** • This 
list is specified as a si£iaa SlJ'stl^ as the list should 
appear on the NQGO loader directive (a string Is used to 
allow the specification of so-called "special" entry 
points which have a syntax unacceptable to SES)* 



(optional) list of eXtra Loader Directives* This 
parameter takes the form of a list of character strings 
which are inserted Into the contr*ol statement stream, in 
addition to those normally generated, thus allowing you to 
supply extra directives over and above the standard ones* 



(optional) controls whether the linked program includes 
the CY8IL INTERACTIVE OEBUGger (CCDBS) or the CYBER 
INTERACTIVE OEBUGger (CID)* If you code the debug 
parameter, the program will be able to be run under 
control of the requested debugger* (by preceding a call to 
the program with the control state^nent DE8UG(0N))* Legal 
values are CCOBG and CID* If no value is given, CCDBG is 
used* NOTE! if DEBUG is specified, the tables used by the 
debugger are placed on file IIZIZOT * This file must also 
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be saved and wade local if the absolute binary is to be 
used at a later time* 



isMi I lb or cybci ib t 

C optional) fifti provides a convenle'^ce when linking 
prograi»s written in the CY8IL or ISML language* If you 
are linking such a prograw* yba ar*e advised to use the 
appropriate Kfii for the language In question* since such 
usage causes the LINK170 pr^tjcedurs to acquire the 
necessary library and generate nf\y ot?ier necessary loader 
directives associated with LIKIng a program in the 
designated language* 



el or err lev! J 

this Coptlonal) parameter controls the £rrbr ievel at which 
the loader aborts without producing any absolutes* Valid 
values for the el parameter are s 

NONE only ♦"terminal •• errors cause an aborl:* 
FATAL only fatal errors cause an abort* 
ALL all errors Cboth fatal and fionfatal) cause an abort* 
ALL is the ^stmLt for LINK170* 

A default value for the el parameter nay be set up via the 
err lev I profile variable if you don't wish to keep 
overriding the default by coding the oaraneter* 



Examples of LIHK170 tisage 

ses*ilnkl70 b'txtfora* l«iiiapf or «# lo 
REVERT, END LINK170 TXTFORH 

This example shows LINK170 used to link a program* The 
relocatable binaries are assumed to be on file l^ot and the LINKed 
program appears on file txtform* A partial load mnp Is written to 
f i I e napform* 

ses*ilnkl70 p«(!iyi ib» your I Ib) themap full cybcllb debug 
REVERT. END LINK170 LGOB^ZZZZZOT 

This example illustrates the use of multlole user libraries and 
in particular the use of the CYBIL run-time library* The 
relocatable binaries are assumed to be oi file I go* the linked 
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program Cwith CYBIL INTERACTIVE DEBUG) Is virlttan to file I gob and a 
full load aiap is *«rltten to file tlienap*! Oabug symbol tables are 
written to file zzzzzdt* 



ses«llnkI70 b«abs» p«<soiirel Ibf (tfti 1 1 ibf Jbf )}f •%! 
• •? f»ICrelo» oreof JeeH 
REVERT. END LINKITO ABS 

This example shovis files relo and oreo* beforiglng to user Jee* 
being linked using library sotnelib* which is eltfier* local to the job 
or belongs to the current usert and library utif fib *«hich belongs to 
user Jbf. The linked prografu is written to file abs« Files relo» 
oreo» and utillib are returned when the link Is coifip!eted> but file 
sonellb Is left local. 
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9.12 XREFMAP - GENERATE A CROSS-REFERENCE FRO^ A LOAD HAR 

XREFMAP is used to generate a neat cross-ref erSf^ce from a load 
mapm XREFHAP outputs the cross-reference I fi 3 foriatst module names 
ifith external referencssf siodule name with it's contained entry 
points and which external modules reference each entry point* and a 
list of ail entry points with containing module nafne and who 
references that entry point* Parameters to XREF^AP are J 



I or b 



un 



naiH8 of load wap which is to be cross-referenced* The 
load map must have been created withf at least* the 10«EX 
option on the tINK170 call. 



(optional } user nawe of catalog to search for Input file* 
The default Is the current user* 



(optionall name of the output file to receive the output 

frow XREFMAP* If you don't code the f pararoeter* a 

default listing file name of LISTIniG Is used* 

print or prt » 

this (optional! ls£i controls the autoiatic printing of the 
output f I le* 



batch Job parameters : 

These parameters are described In the section entitled 
••SES PROCEDURES RUN AS BATCH JOBS". The default for this 
procedure is to run in batch node* but It can be run in 
I ocai mode* 
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GETCCOB provides an alternate way to actiiilre CfllL INTERACTIVE 
DEBUG <CCD8GI« Nor mall y, CCOBG Is acquired when necessary by the 
LINK170 procedure. If the LINK170 procedure Is not to be used in 
the current session, though, the necessary files nust be explicitly 
attached. There are no parameters to the SETtCDB procedure. 



Example of GETCCOB Usage 



ses«getccdb 

REVERT. CYBIL INTERACTIVE DEBUG AVAILABLE 
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GETLI8(S) ac<!ulres the CY8CLIB or CfBIL13 library ready for 
linking* Parameters to GETLIBISI are s 

cybcl lb or cybiiib : 

(optional) liai indicates the library required to be asade 
local* Coding the cybcllb ^21 acquires the CY8Ii-CC 
library* Coding the cybifib fex acquires the CY3IL-CI 
1 i brar y* 



Examples of GETilBfSm^a^e 



ses«9etiib cybciib 

i^EVERT* END GETLIB CYBCLIB IS LOCAL 



ses*getlibs cybillb 

REVERT. END GETLIBS CYBILIB IS LOCAL 
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9.15 £IMtii.-«gy !ii^£iaiL^£MI£MB£liI 

CYBENV provides a CYBIi environment »4i th many options* 
Facilities inciude source code creation an^ mocffficatlon using FSE» 
source fnanagement* source forfflatting* compil I ng» a?^d FSE Interfaces 
in split screen for error correction* 

create or modify or compile or cybH_to«sct or' set or add or 
get or iist^base or del mod or del con s 

Crequiredl function name of CYBEI^ ootioi to execute* 

create - lets you create tl?e dec!<<s) specified by the m 
parameter using FSE and then adds the deckCs) to the 
specified base* 

modify - lets you modify the deckCs) specified by the m 
parameter using FSE and then replaces the deck<s) to 
the specified base* 

compile - Compiles the deckCsl specified by the m parameter* 
If there are compilation errors* you have the option 
of correcting the errors in the source using FSE In a 
split screen mode* The top oirt of the screen will 
be the source and the bottoi half will be the listing 
with the error message(s} under the flne(s) with the 
erroris)* You can also read the offline CYBII manual 
by pressing the ASSIST function key in FSE* 

cybll.to.sct or set - Produces structure charts of the specified 

deckCs)* There can be no coTiollatlon errors in the 

deckCs) specified or the structure charts will not be 

generated* You have an option of using the CAOSG 

procedure to look at the structure charts produced* 

get - Gets deckCs) from the base specified and puts the 

deck<s) on the file specified by the g parameter. 

add - Adds deckts) on the file speclflsd by the g parameter 

to the base specified* 

delmod - Deletes deckis) from the base specified* 

deicoffl - Deletes common deck(s) from the base specified* 

Parameters to the CYBENV procedure are s 

ffl or al I t 
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This frequi red) parameter specifies a fist of modules 
(Including ranges of fiiodyles) tNat will be affected by the 
option specified* If the ail ls§x 1 s coded* a compile file 
for ALL of the Ir egyf ar> roodui es^ 1 n the specified baselsl 
Is produced* 



b or I 



(optional) name of Base Library from vihlch to generate the 
coiBpMe file* If you don't code the b part*Ret8r# CYBENV 
uses the value of profile variable base as the name of the 
base library, and If there's no such variable deflnedt 
CYBENV uses the nawe base* 



un : 

(optional) User Name In Mhose catalog the base specified 
by b may be found* If you doi't code the un parameter, 
CYBENV uses the value of profile variable baseoiin as the 
name of the base library, and If there's no such variable 
defined, CYBENV assumes that the base is in the current 
user's catalog* 

Note : If the User Harae is different than the current user, and 
using the modify or create options, CYBP^V w1 !1 ol ace the deckis) 
on a base library that is the value of the profile variable base, 
or the name base If no profile variable exists.' The specified 
base library in the different catalog i«in then be added as an 
alternate base. 



(optional) name of file to receive the nodules extracted 
from the base. If you don't code the g parameter, CYBENV 
uses the name group as the name of the file. 



cors or c : 

(optional) name of file containing CORrectlon Sets to be 
temporarily applied against the base b prior to generating 
the compile file. If you code the cors Parameter, CYBENV 
uses procedure TEHPCOR to make the temporary corrections 
before generating the compile file. 



ab or at 



(optional) list of Alternate Bases from which to satisfy 
calls to common modules. The ab parameter may be coded as 
a multl valued list of sublists. Each element of the 
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value list is either a single r^afae, f?i wtiicb case It 
refers to t^e nasne of an alter*fiate base already assigned 
to the job, or In the current iiser'*s catalog, a,t an 
eienent in a sublist. In which case, the last sub element 
in the sublist Is a user name In s^hose catalog the bases 
referred to by the other sub elei^ents of the sublist may 
be found. See the example at the Br\6 of the description 
of GENCOMP to help eake tl?is clear.; 



cybccnn or cybicmn > 

(optional} ls£x specifies an SES saoplled Alternate Base for 
use In satisfying calls to comnon isodufes Csee the ab 
parawieter described above). If you cods the cybccnin ls£j£, 
the base containing CoMwoN modules for' use by CY8Ii CC 
programs Is selected. If you code the cyblcmn Ji^i, the 
base containing CoMmon modules for* use by CYBIL CI programs 
is selected. By default, cybccnn Is selected for use in 
generating the compile file. 



CO or ci or cm or cp or cs 2 

(optionall Jsfil determines the coupMer used. By default, 
the CYBIL CC compiler Is used. If you code the cl key, 
the CYBIL CI compiler is used. If you code the cm key, 
the CYBIL CM compiler Is used.; If you code the cp key, 
the CYBIL CP compiler Is used* If you code the cs key, 
the CYBIL CS compiler is used.^ illaJtS • fou can set your 
own default compiler selection M your* pro fi le by setting 
a variable called cybll to this key. 



io 



this (optional) parameter specifies the Options to be used 
when producing the Listing. \ny combination of the 
following designators may be coded for this parameter s 

a specifies that a map of the source input block 
structure and stack Is to be produced 

f specifies that a full listing Is to be produced 
(selects list options S, A, aid R) 

specifies that the listing should Include the generated 
object code in an assembler-like format 

s specifies that the listing of the source input file is 
to be produced 

w specifies that the listinqi of warning diagnostic 
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rnessages Is to be suppressed 

r specifies that a syraboHc cross reference listing Is to 
be produced 

ra specifies that a symbolic cross refer er^ce listing of 
all prograsB entities is to be produced whether 
referenced or not 

X works in conjunction with the LISTEXT pragwat such that 
LISTings can be EXTernally coitrbtled via the compiler 
call statement* 

If US. is specified, no llstin?? Is produced* If the lo 
parameter Is omitted* a listing af the source Input file 
only is produced* 

chk or nochk i 

this (optional) parameter sped f I es tiie run-time checks 
the compiler is to generate* If you code q2 ^or this 
parameter or Diiitsll^ no run-time checking code is 
generated* If you code any combination of a <check for 
de-reference of NIL pointer), £ CcHieck v^lue ranges— range 
checking may add as much as 3 If Z words to the generated 
object code for each range check performed) and s Ccheck 
subscript ranges), the corresponding checking code is 
generated and omitted chec^^^ng options cause the 
corresponding checks to be suppressed* If you omit the 
chk parameter, CY8IL generates* all flavors of run-time 
checks* 



debug or d or nodebug : 

this (optional) parameter is used to select the debug 
options to be in effect for* the compilation* The 
available debug options are : 

sd If this option is selected* the compiler Includes 
Symbol Table Information in the object code file to 
be used by the CYBIL interactive debugger* If this 
option is not selected It isn't possible to 
symbolically debug the moduleCs) being compiled* 

fd This option produces the saiie tables as d*sd plus 
stylizes the generated code to provide a step 
facility when using the symbolic debugger (it Is only 
meaningful, currently, when used with the CC 
compt I er ) • 
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opt 



bin 



ds If this option is selected the Debugging Statements 
appearing between ?f noco^iplle ?? nn6 ?? cowplle ?? 
pragwats is coppiledy otherwise sueh stateiaents are 
skipped by the co?Bpiler« 

If you omit this pararaeter* aft the debug options are 
selected* If you code the nodebtig fssx^ none of the sd* fd 
or ds options are selected* If you code the debug or d 
ll£X^ l3*^t don't code any yaluesf debiig«sd is used. To 
select combined options you can code debug«Csd»dsl or 
debtig^Cfdydsl* 



this {optional) parameter is used to select optimization 
levels in the generated code (not supported for all 
compiler impi ementatlons) • Legltli^ats values are s 

Provides for keeping constant values in registers. 

1 Provides for keeping local variables in registers. 

2 Eliminate redundant memory references and common 
subexpr essi ons. 



(optional) name of file to receive the Binary object code 

generated by the compiler. If you don't code the bin 

parameter* the binaries appear or^ a file called Igo. If 

you give a value of null to the bin oaraiteter* no binary 
is generated. 
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10.0 £II£E«iSS-liEiy4i«iMliBQM!l£MI«£IIlIiaimi.ll!lUL4II0M 



*'SiMulatiofi ain*t Mhat it*s going to be" 

Neif Sci entlst 



This chapter describes the SES ut i H ties for creat ing and ysing 
the CYBER 180 Virtual Environwent on ths CYBER 170. Facilities 
described in this chapter are s 

SIH180 run the CY3ER 180 Hardware Systen Slaiulator. 

TQ180 convert a NOS/170 text file for use with the simulated 

NQS/VE I/O available through the SIH183 procedure* 

T0170 NOS/170 to NQS/170 INTERFACE file conversion* 



FR0H180 convert a simulated NOS/VE I/O text file to a NOS/170 text 
f i fe. 



FR0M170 converts NOS/170 INTERFACE foriaat files to NOS/170 format. 

DUNP180 dumps the contents of a simulated '^OS/VE fife. 

DUMP170 dumps the contents of a NOS/170 INTERFACE format file. 

GENCPF link CYBER 180 binaries and generate a Checkpoint File. 

VEtINK link CYBER 180 binaries and produce Segfi^e^t Fi I es. 

VEGEN generate a CYBER 180 Checkpoint Fife from Segment Files. 
GETLIBISJget CYBIL run time library local to Job. 

GETOSI make HCS lOU Deadstart tape generat3f local to job* 
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SETLDB »take HCS NQS Environment Interface Loader local to job* 
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SIH180 runs the CY8ER 180 Hardware System Simulator <often 
referred to as the HSS)« The hardware system that is simulated 
consists of the following components 5 

1. CPU 

2* Central Memory C16 Megabytes) 

3. 10(10) Peripheral Processors C?f>s) 

4. 12C10I I/O Channels 

5* Z 7154 disk controllers sharing 4 844-4x disk storage 
un I ts« 

6. 2 7155-1 disk controllers sharlrig 2 844-4x and 2 885~lx 
disk storage units* 

7. 2 7155-14 disk controllers sharping 2 344-4x, 2 885-lx 
and 2 885-42 disk storage units •! 

SIM180 sets up the total systefli siinulated environment and gives 
control to the CY8ER 180 simulator* At this paint* the user may 
enter any valid simulator command* Slmulatof coiswands provide the 
user with control over the simulated envirbriment whi ch includes the 
following capabilities : 

1* CPU and PP memory loading 

2* Interpretive CPU and PP instruction execution 

3* CPU and P? breakpoint 

4* CPU and P? trace 

5* Display and change Central and !*P 'pemor i es 

6* Dump Central and PP memories to a specified file 

7. Display and change CPU and P?* registers 

8* Checkpoint / Restart 

9* On /off CPU and PP simulation 

10* CPU keypoint 

11* CPU program performance monitoring 

The CYBER 180 simulator Is intended prinarlly for interactive use 

(local mode) but may be readily used in batch* An example of batch 

submission of a Simulator run is given below* Parameters to $IM180 
are « 



restart or rs s 

(optional) name of a checkpoint fl1« fron which to restart 
simulation* The checkpoint ^lle may be one previously 
created by GENCPF (££iierate QlieckPoInt £ile), VEGEN 
(Virtual fnvironment 5£tierator)» or via the simulator 
CHECKPOINT command* If you don»t code the restart 
parameter* a complete simulated system is created* 
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cf 



(optional) name of a coi»i»and fi!^ ^hicN is to be processed 
iiniaedi ately upon activation of the siiulator* The cowJRand 
file consists of one or more valid sli^ulator copmandCs). 
This parameter Is required when r'unnif^g In batch* 



1180 or i 5 

(optional) name of file cental ?iintj Input for the special 
sifflulator CPU I/O instruction (op code Fi=fl6))* If you're 
running SIM180 interactively and don't code the 1180 
parameter^ SIM180 takes its Input fron a file assigned to 
your terminal* If you run SIH18D In batch and use the CPU 
I/O instruction for Input* you mast supply a file 
containing the input* 



0180 or o : 

(optional) nawe of file to receive output froiR the special 
simulator CPU I/O Instruction (op cade FFC16))* If you're 
running SIHi80 Interactively and don't code the ol80 
parameter^ SIM180 sends output to a file assigned to your 
terminal* If you run SIHISO li batch* you must supply a 
file to receive the output* otherwise the output is lost* 



Examples of SIN180 Usage 

ses*sl mldO 

*♦ I SH 6052s CYBER 180 SIHULATOR VER 6.^ LEV 133 CMIGOS REV S) 

This example shows SII1180 used J nter act! vel y* to create a new 
simulated system environment* The user may enter any simulator 
command once the simulator banner Is displayed* 



ses*siml80 rs'checkl cf«errata 

♦♦ I SM 6052* CYBER 180 SIHULATOR VER 5.17 LEV 133 (MIGOS REV S) 

This example shows SI Ml 80 used to resjme sluuiation from a 
checkpoint file. The command file errata is processed before 
requesting additional simulator commands from tNe user* 

ses*slml80 eheckx Mindata o«outdata 

♦♦ I SM 6052: CYBER 180 SIMULATOR VER 5*'7 LEV 133 (MIGDS REV S) 
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This example shows SIM18G used interact I vef y# to resuwe 
simulation from the checkpoint file checks* The special st^ytator 
CPU I/O instruction* when encountered during CPU Instruction 
simulation* is to read input from file indata and Is to write output 
to file outdata. 

ses.do batchn* fite»siflief*««««* 

«•? cs«(*ses«sial80 postds* cf«siiiicff o«pri9(|Oitt *»•••«• 

••? *save»sesiog* ) 

15. 54. 28, SUBIIIT COMPLETE. 40BNAHE IS AAAQCBN 
REVERT. JOB 00 SUBMITTED 

This example shows SIM180 submitted for batch running via the SES 
DO procedure* Simulation will resuiae from the checkpoint file 
postds* the simulator commands In the file simcf are processed* and 
any output from the special simulator CPU I/O instruction is 
directed to file progout. Refer to the des^crlot Ion of the SES 00 
procedure in the "Hi seel I aneous Useful Soodles** section for an 
explanation of using DO to submit multiple control^ statements to 
batch. 
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T0180 converts a NQS/170 fUe containing character data to 
SIMULATED NOS/VE file fornsat. Only character data can be converted. 
Paranieters of T0180 are? 



I or f 



The Input or File parameter specifies the NOS/170 format 
file to be converted. 



The <optionan Output paraaieter specifies the SIHULATEO 
NOS/VE format fife to receive the converted data. If this 
parameter is omitted then the output and input file names 
are the same. 



CS612 or cs64 : 

These (optlonai) lifiis indicate whether' the N0S/17G format 
file Is upper/ loHer case ascil (cs6l2r or whether It Is a 
64 character set ascil or display code file (€s64). If no 
keyword Is given then cs6I2 Is used. 
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10.3 IQnS«r^!iQS/12fi^ia-!IQlil2S«IMIIB£A£f-IlIS-k31ieiliQM 

TQ170 converts a NQS/170 file containi?i<i character data to the 
NOS/170 INTERFACE format of sirpulated NOS/VE iro. It is similar to 
T0180 except that the output file content Is different. Parai^eters 
to T0170 are t 



I or f : 

NaflBe of the Input £1 1 e to be converted. 



(optional) name of file to receive the QKitPntp that iSf the 
NOS/170 INTERFACE format data. If you don't code the o 
parameter* the output appears on the file specified by the 
i parameter. 



C5612 or cs64 s 

these (optional) l£Jis specify the character set of the 
Input file. TQ170 assumes the Input file is In cs612 
character set. 
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10. 4 Fgflj|iia^r-.SIIiyLAI£B-MI3SZM£.Ifi-IIQiil2Q:.i?Iil.i:QII¥l£SiO!i 

FRQNISO converts a file in SIMULATED MOS/VE format containing 
character data to N0S/17G forwat. Conversion stops whenever an 
error is found on the SIMULATED NQS/VE format file. Such errors 
include invalid record headers on the file and non-ASCII data In the 
records. The NOS/170 forjaat file fnay be printed with an SES. PRINT 
coi»»and> or Input to any other normal NflS/170 program. Parameters 
of FROHISO are : 



I or f 



The Input or File parameter specifies the source data* 
SIMULATED NOS/VE format file. 



The CoptionaU Output parameter* specifies the NOS/170 
format fife. If this parameter is omitted then Input and 
Output file names are the same. 



cs612 or cs64 t 

These keywords indicate the character* set of the output* 
NQS/170 format file. Upper/lower case ASCII is Indicated 
by the keyword cs612 and the keyword cs64 Indicated a 64 
character set ASCII or display code. If this parameter Is 
omitted then cs612 Is used. 
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FR0M170 converts NQS/170 INTERFACE format file containing 
character set data to NOS/170 format. Conversion stops when an 
error is found in the NQS/170 INTERFACE format file. Such errors 
include invalid record headers in the file* and non ASCII data in 
the records. The NOS/170 file may be printed via the SES PRINT 
procedure* or input to any other normal NOS/170 program* Parameters 
to FR0N170 %r& s 



I or f 



name of Input £ile to be convertel. 



(optional) name of file to receive the Qutput of FR0M170. 
If you don't code the o pararoetBr* the output appears on 
the file specified by the I parameter. 

CS612 or cs64 2 

these Coptional) li£i^ specify the character set of the 
output filef and correspond to the sawe parameters on the 
FRQM180 procedure* 
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10.6 mii£lil^-=.iiiyL4I£fi«MQUl£-£iLI.nmS£ 

0UMP180 dumps the contents of a simulated NOS/VE file. It is 
similar to HEXOMR except that it checks the records and data 
structure of the file and diagnoses errors i«hlch prevent FR0H180 
from converting the file. ParaiRcters to D!J*1?*18D are s 

I or f J 

name of the file to be dumped. 



o : 

(optional) naiae of file to receive the du^p* If you don't 
code the o parameter* the duaip output appears on file 
output. 



cs6I2 or cs64 J 

these (optional) JSfixi specify the character set of the 
output filef as in the FRQH180 procedure* 



fw : 

(optional) £irst Mord of the file to djinp. The default is 
to start at word 0. 



(optional) iast )iof4 of the file to dump. The default is 
to dump up to end of information (E3I). 
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10.7 0UHP170 - NOS/170 INTERFACE FILE DU^^P 

DUHP170 dufflps the contents of a NOS/179 INTERFACE format file. 
It is similar to DUHP180> except that Oyn?>l70 also checks the record 
and data structure of the input file and diagnoses errors which 
prevent FR0M170 froflt converting the file. ParasReters to 0UHP170 
ares 

I or f s 

name of the input £ile to be dumoed. 

o : 

Coptionai) name of Qutput file to r'ecelve the dump. If you 
don't code the o parameter* the output appears on file 
output. 



cs612 or cs64 « 

these ^optional )li£is specify the character set of the 
output file. 0UMP170 assumes the cs612 character set. 



fw : 

Coptional) £irst ^or6 from which to start dumping. If you 
don't code the fw parameter* the duinp starts from word 0. 



iw : 

(optional) Last Mord to be dumped. If you don't code the 
Iw parameter* the dump goes to en^l of Information CEQI). 
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1G»8 GENCPF - GENERATE A CHECKPOINT FILE CCP1=1 

GENCPF executes the SES Virtual €nviron^e?it Linker and the SES 
Virtual Enirl ronment Generator to product 9 Checkpoint Fi I e CCPF) 
which can be loaded and executed on the CYBEI? 180 Hardware Systew 
Simulator. The user raust provide a f i I e contalnl ng CYBER 180 object 
text* and can optionally provide a Linker Paraisetar* File CLPF)f a 
set of HonI tor Segment files* and/or a Virtual Environment Generator 
OIRective file* The !»f file contains the map produced by the 
Virtual Environment Linker and additional Inforiiation produced by 
the Virtual Environwent Generator. 

Notes wost of the following parameters aren't needed by the 
••gener al public" Cexamplss show general usage). 

Parameters to GENCPF ares 



ofl 5 CF I lenaffie<s)> optional) 

QbJect^Fi le^List - list of u» to ID names of files 
containing CY8ER 180 object text (ver 1.4). This 
parameter does not have a default. 



Ifl 5 (Fi lenameCs)f optional) 

L ibrary^FH e^Li st ~ list of up to 13 naiRes of Library 
files containing CY8ER 180 object text. This parameter 
does not have a default. 



pep i <String(31)> optional) 

Pr imary.Entry^PoInt - This parameter specifies the entry 

point at which to start execution. The default is to 

start execution at the first Transfer symbol encountered. 



ns s CString(4)* optional) 

Name^Seed - This parameter specifies the ♦•name seed" for 
the Virtual Environment Linker Sequent files. The default 
for this parameter is segm. The value of this parameter 
overrides any Linker Par ameter Fl I e specification of this 
field. 



mf 1 (Filename* optional) 

liap.File - This parameter specifies the name of the map 
file. The default for this parameter is llnkmap. 
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flIO 3 



this Coptlonall paranseter detsr^lties the linker Hap 
Qptions. IRQ determines the aiRoufit of I nfor aiati on outpyt on 
the linker map. Any value coded far lo overrides the 
default options chosen by the linker parameter file CLPFI. 
The value of the mo parameter Is aias ^f the following 
characters s 

H no wap i nf orfiiation j di agnosti cs are output. 

S Section allocations for every section of every Input 

object module* 
E section allocations plus Entry point names and address 

as si gnments* 
rt section allocations and entry points plus output 

segment and cowiaon block allocations (this fast option 

is in fact a full linker mapl. 



rewind or noreii t 

these (optional) llfiXS determine whether to ££MIMfi the 
linker map file before writing it.? The default action is 
to rewind the map file* The |i5i coded overrides any Mnker 
parameter file specifications. 



Ipf i 



(optional) name of LI nker.Par ameter .Flf e containing Linker 
parameters that affect the link process. I <* you don't code 
the Ipf parameter* default values are applied as in the 
description of the LPE. 



cpf i (Filename^ optional) 

Checkpoint.FI le - This parameter soeclfies the name of the 
file containing the output from the Virtual Environment 
Generator. The default Is cpflle. The value of this 
parameter overrides any Linker Parameter File 
specification of this field. 



cybilib s (Keyword* optional) 

If you code the (optional) kg^> SEMCPF uses CYBILIB to 
satisfy externals during the Linking process. GENCPF 
ACQUIRERS CYBILIB from SES and adds it to the 
L Ibrary^FII e^LI St. The default Is not to use CYBILIB as 
part of the Link. 



dir or Idrdlr or d : (Filename* optional) 

Directives - This parameter specifies the name of a file 
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containing directives to the VE Sensrator* The default is 
a file containing default directives. 

fRtrns or mns s CStringC4l» optional) 

Monitor Narae.Seed -- This paraieter' s»eci f i es the ••name 
seed*' of the Virtual Environwent Linker Seirnent files that 
contain the Monitor code* This? oammeter Is provided so 
users can have their own Monitor urogram. The default for 
this parameter is mtrx* The orocedure checks the local 
files* the local PF catalog* and then the SES catalog to 
get the files. 



Examples of GENCPF Usage 

The following example shows how to cosipile a test prograni written in 
CYBIL* generate a VE File* and run it on the Sinulator* 

ses.cybl I ci i«testprg l«testlst b«test1go 
ses«9encpf of latest! go cpf«testcpf cyblllb 
ses«slffil80 restart«testcpf 
? run 
? bye 

The last two lines were Simulator comiiands* 

This example shows how to generate a Ci*^^ '•rom several input files 
of CYBER 180 object text. 

ses.gencpf of l«f mylgolf iiylgoZ) cpf'myepf 
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10.9 E£Uili-.r-£^I£yi£-Ilii-MiEiyiL«iliMlEllMailI.LIMSl 

VELINK executes the Virtual Environiaent Linker fSft^icti links data 
from CYBER 180 object f lies/ 1 1 br ar les and produces a map file and a 
set of SEGHent files. VELINK is set up so that users can specify 
their otin Linker Parameter File (LPF) containing Virtual Environment 
Linker variables that control the linkage. 

Note? VELIHK is generally used only In soeclal oasesf where 
SENCPF Is inadequate. 

Parameters to VELINK arei 

ofl s CFI lenaiiieCs)# optional) 

Object.Fi le^List - list of up to ID naiaes of files 
containing CYBER 180 object text tver 1.4). This 

parameter does not have a default. 

Ifl : (Fi lenanie(s)f optional) 

Library. Fi I e_Li st - list of no to 13 names of Library 
files containing CYBER 130 object text. This parameter 
does not have a default. 

pep i CStrlngOD* optional) 

Pr imary.Entry.Point - This parameter* specifies the entry 
point at which to start execution. The default is to 
start execution at the first Transfer symbol encountered. 

ns s {String<4)» optional) 

Name.Seed - This parameter specifies the "name seed** for 
the Virtual Environment Linker Segment f 1 1 es. The default 
for this parameter Is segii. The value of this parameter 
overrides any Linker Parameter File specification of this 
field. 

mf : (Filename^ optional) 

Hap.File - This parameter specifies the name of the map 
file. The default for this parameter* Is linkmap. The 
value of this parameter overrides any Linker Parameter 
File specification of this field. 

mo i 



10-16 
CDC - SOFTWARE ENSINiERING SERVICES 

18 Oecefflber 84 
SES User's Handbook REV? 4A 

10.0 CYBER 180 VIRTUAL EHVIRONHENT CREATfO?^ AND SINGULATION 
10.9 VELINK - EXECUTE THE VIRTUAL ENVIROM'IE^^T LIN<ER 



this (optional) parameter deterlfiines the linker lap 
Qptions* «o determines the amou?it of inforination output on 
the linker wap. Any value coded for* lo overrides the 
default options chosen by the 1 1 nicer aafaweter file <LPF). 
The value of the mo paraiweter Is q,q£ of the fol lowing 
characters s 

N no map Inf orniat i onj diagnostics are output. 

S Section allocations for every section of every input 

object module. 
E section allocations plus £ntrV oolntiai^es and address 

assignments. 
H section allocations and e'^trV points plus output 

segment and cofflmon block allocatlois (this last option 

Is In fact a full linker m^p} •' 



reifind or noreit 5 

these (optional I K&tS. deterfulne whether to E£MIHi2 the 
linker map file before writing It. The default action Is 
to rewind the map file. The |isi coded overrides any linker 
parameter file specifications. 



debug i 



code this Ks^ ^f you want the llni<er' to generate a file 
containing module address and entry point information. The 
file name Is the name seed appended with 'OBG*. If you 
don't code this liaif no file Is generated.! 



Ipf t 



(optional) name of L I nker.Par ameter.F1 1 e containing Linker 

parameters that affect the link process. If you don't code 

the Ipf parameter^ default values are applied as in the 
description of the LPF. 

cybifib t (Keywords optional) 

If you code the (optional) \is,t9 V?LINK uses CY8ILI8 to 

satisfy externals during the linking process. VELINK 
ACQUIRE's CYBILIB from SES and add it to the 

Library. Fil e^Llst. The default Is not to use CYBILIB as 
part of the Link. 



Example of VELINK Usage 
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Ir^ the following exaaipie the Linker is passed a Linker Parameter 
File. Object files york and hunt are linked using racelib as an 
object library. 

ses.velink ofl«Cyork#hynt) lfl«fliylib If>f«i8y1|>f 
R€VERT, SND VELINK 
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10.10 i£i£M-.r-£^£iiyi£.IM£.l£^.itIIIUiL.£linS1311EliI-iilI£^iaE 

VEGEN executes the SES Virtual Envlroniter^t Generator to produce a 
Checkpoint File (CPFI which can be loaded a?^d executed on the CYBER 
180 Hardware System Sinuiator* The input to tha Virtual Environment 
Generator Is the set of Segment files containing the users program* 
and a default set of segment files that contain a simple monitor 
program* The monitor program contains code that sets up the 
exchange packages* stack areas* and aisu provides a primitive 
Monitor and Trap Handler routines* and a Teritlnatlon routine* 

Notes VEGEN is generally used only in special cases* where GENCPF 
Is Inadequate* 

Parameters to VEGEN ares 



dlr or Idrdir or d s IFIIename* optional) 

Directives - This parameter specifies the name of a file 
containing directives to the VE Generator'* The default is 
a file containing default directives* 

ns s (String<4)* optional) 

Name^Seed - This parameter specifies the ••name seed*» of 
the Virtual Environment L Inker Segfnent f I les* The default 
for this parameter Is sega* 

ntrns or mns s (Strlng{4)* optional) 

Monitor Name.Seed - This parameter specifies the ••name 
seed'* of the Virtual Envi ronment L I nker Segment fi les that 
contain the Monitor code* This parameter* Is provided so 
users can have their own Monitor program* The default for 
this parameter is ntrx* VEGEN ciiecks the local files* the 
current user^s catalog* and then the SES catalog to get 
the f i I es* 



cpf s ^Filename* optional) 

Checkpolnt^FI f e - This par ameter* sped f I es the name of the 
file containing the output from the Virtual Environment 
Generator* The default is cpfM^* 

mf : (Filename* optional) 

Map^Flle - This parameter specifies the name of the file 
on which to write the map information* The default Is 
I Inkmap* 
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Example of VEGEN Usage 

In the foMoHing exampie* the Generator is aassad a directive fite* 
a set of segment flies containing the test procirai«» a set of monitor 
files* and produces a CPF and Hap file. 

sesvvegen dir«!iyclir ns«'test« «trns«'itfx* cpf«f!iycpf »f»«yaiap 
REVERT* €N0 VEGEN 
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10,11 S£ILlI-flE«fiIILli5-=«I£ailiE£.LISIMX-lBiaillKIlS 

GETLI8<S) acquires the CY8CLIB or CY8ILIB library ready for 
linking. Parameters to GETLIBCS) are s 

cybct ib or cybi I ib i 

(optionaH Isfil indicates ttie flbrary required to be made 
local. Coding the cybcMb kgi acquires the CYBIL-CC 
library. Coding the cybllib ^t acquires the CY8IL-CI 
I i brar y. 



Exanples of GETLIBCS) Jsage 



ses,getllb cybctib 

REVERT. END GETLIB CYBCLIB IS LOCAL 



ses.getiibs cybitib 

REVERT. END GETLIBS CYBILIB IS LOCAL 
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GETDSI acquires the absolute binary to riii^ the 4CS lOU deadstart 
tape generator. There are no parameters. 



Example of GETOSI Usage 



ses*9etdsi 

REVERT. END GETOSI VGENOSI IS LOCAL 
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10.13 SiILai-r«MSUIE£-.IlMA£X«£aS-£MiISA-.llI*-.La^I£E 

GETIOB acquires the absolute binary to run the HCS Envlronflient 
Interface loader. There are no par ameters^l 



Example of GETIOB Usage 



ses.getldb 

REVERT. END SETLOB V6ENLDB IS LOCAL 
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11.0 IIQIQEQU«6Maa*£i^IEMB£iI 



This chapter describes the SES uti I i ti es ^or creati ng and using 
the Motorola 68000 Env ironfiient . Facilities described In this 
chapter are s 



ASN68K 



execute the NC68000 assefflbler'. 



LINK68K 



execute the MC68000 absolute tinker. 



BIMD68K 



create a single bound load module. 



TRAN68K 



generate a file of Motorola S records from the output 
files of the MC68000 absolute linker. 



REF0RM68K 



reforinat a module to H-P object text format. 



BtDMI68K 



generates an absolute module fron the output files of 
the MC68000 absolute linker. 



GEN6S6SK 



translates a global symbols file into H-P format. 



PURSYM68K removes debug symbol tables* generated by CY3IL/CM or 

the MC68000 assembler^ from nadules an object files or 
object libraries. 



TRANOILIB 



translate DI libraries. 
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11*1 ASM68K - EXECUTE THE HOTDROIA 68000 ASSEIISLCR ON 170 

A$H68K executes the Hotorola 68000 asseibfer on the C170* 

This procedure is arranged so that It does not abort* If there 
are any asseiablyt Ime errors detected? the NOS Job Control Register 
called EFS is set to a non-zero value* When this procedure Is being 
used as a building block* this feature is used to deterfnine what 
steps should be taken subsequent to runnif^g the assembler* 

Parameters to the ASM68K procedure are s 

i or Input s 

(optional) name of the Input file to be assembled* If you 
don't code the I parameter* ASH58< assunes that the Input 
is on a file called Input* 

b or binary s 

(optional) name of the file to receive the object code 
generated by the assembler* If you don't code the b 
parameter the object code hI I I be ^rltte^ to a file called 
Igo* This fife Is not rewound by the ASM68K procedure* 

I or listing : 

(optional) name of the file to receive the Listing from 
the assembler* If you don't code the I parameter the 
assembler output appears on a file called listing* This 
file is not rewound by the ASH68< procedure* 

X or xref : 

(optional) keyword parameter selecting a cross reference 
listing* If you don't code this parameter no cross 
reference listing Is produced* 

debug or d : 

if you code this h§l9 the assembler generates debug symbol 

tables in the object code file* If you don't code this 

k&l9 the assembler doesn't generate the debug information* 

nsg or nomsg t 

These (optional) ilfi^i control the generation of 
informative messages by this procedure and are fully 
described In the section entitled '•INFORMATIVE MESSAGES 
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FROM SES PROCEDURES". 



col or cols or columns t (lefty right) 

(optionall left starting colunm and right ending column of 
source assembly language statenents.s The default values 
are <1#90). 
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11.2 LINK68K - EXECUTE THE HC68000 ASSQlUTf LI^IKE^ 



11.2 UliS6aii«r^Il£ayif .liJf «MiIMMj2-.MiQL!iIi:.LIM^IS 

LINK68K executes tbe MC68000 Absolute Lir^ker» ^thlch links data 
from Si$ object f i les/l ibrar I es and produces a nap file and a set of 
SEQMent files. LINK68K is set up so that users can specify their 
own Linker Paraweter File ILPFI containing NCS8030 Absolute Linker 
variables that control the linkage. 

Parameters to LINK68K ares 



ofl s <Fi lenarae(slj optional) 

ObJect^Fi le^List - list of up to ID names of files 
containing SES object text (ver 1.4). Tfiis parameter does 
not have a default. 



If! 5 CFi lenameCs}^ optional) 

Library^FII e_Li st - list of up to ID ?^a?»es of Library 
files containing SES object text. This parameter does not 
have a default. 



sp i CString(31)# optional) 

Start ing^Procedure ~ This parameter specifies the entry 
point at *ihich to start execution. The default is to 
start execution at the first Trarisfer synhol encountered. 

ns : (Strlng(4)f optional) 

Name. Seed - This parameter specifies t^e "name seed** for 
the MC68000 Absolute Linker Segnaf^t files. The default 
for this parameter Is segm. Tiie value of this parameter 
overrides any Linker Parameter File soecl f I cat I on of this 
field. 



mf : (Filenamef optional) 

Map. File - This parameter specifies the name of the map 
file. The default for this parameter* is Mnkmap. The 
value of this parameter overrides any Linker Parameter 
File specification of this field. 



mo 



this (optional) parameter determines the linker {lap 
Qptions. mo determines the amount of information output on 
the linker map. Any value coded for mo overrides the 
default options chosen by the I i nker oaraiueter f i I e CLPF). 
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The value of the mo parameter Is qm. of the following 
characters * 

N no fflap information? <3I agnostics are output. 

S section allocations for every section of every Input 

object module. 
E section allocations plus £ntry Pol»it names and address 

as si gniaents. 
H section allocations and entry points plus output 

segment and common block allocations (this last option 

is in fact a full linker mapl* 

rewind or norew s 

these (optlonall lii^s determine whether to ££MiMO the 
linker map file before writing it. The default action is 
to rewind the map file. The li^^ caded overrides any linker 
parameter file specifications. 



ipf i 



(optional) name of linker.Par ameter;.FI I e containing Linker 
parameters that affect the link orocess. If you don't code 
the Ipf parameter* default values are applied as In the 
description of the LPF* 



cybml lb s (Keywords optional) 

If you code this (optional) fiajg^ IIMK6SK uses CYBMLIB to 
satisfy externals during the linking process. LINK68K 
ACQUIRE's CY8MLIB from SES and add it to the 
Library.Fi I e.LI St. The default Is not to use CTBHLIB as 



part of the Link. 



debug t 



code this Is5l If you want the linker to generate a file 
containing module address and entry point information* 
The file name is the name seed appended with *OBG». If 
you don't code this jsfil* no file Is generated. 



Example of LXNK68K Usage 

In the following example the Linker is passed a Linker Parameter 
File. Object files york and hunt are linked using myllb as an 
object I i br ary. 
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ses.Hnk68k of MCyorkyhuntI jfl«jiylib ll>f«)iiylpf 
REVERT. END LXNK68K 
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11.3 MMSIiill.r-MMD^a£Mi^i21i«iQIiyUS 

The purpose of this comffland Js to create n single bound load 
module from the specified component object or Idad faodules* The 
code sections of the old modules are coaiblned Into a single code 
section^ data sections «l th Identical attributes are combined Into a 
single section and the binding sections are cornblned and reorganized 
for fulnlaiyra redundancy* Entry point definitions which are 

referenced froi one or wore component fljodules are deleted unless 
they have been explicitly retained on this coisiand or they have been 
previously retained* 

Parameters to the BIN068K are s 



file or f or library or Mb J 

This parameter may be coded as a inultl valued list of 
subllsts* Each element of the vallie list is a single name* 
referring to the n^me of a file already assigned to the Job 
or in the current user's catalog? or the element is a 
subllst* the last sub-element In the subllst is a user name 
In whose catalog the files Cor' libraries) referred to by 
the other sub-elements may be found* An example at the end 
should help clear this up* 



name or n : 

This parameter specifies the moiiile name to be associated 
with the created module* 



module or modules or m : 

(optional) This parameter specifies the modules or nodule 
subranges from files or I i brar i es that are to be components 
of the created module* If not specl f I ed» al I the modules 
on the specified files and libraries will be used as 
components* 



retain or r s 

(optional) This parameter specifies the externally declared 
names referenced by a component of the created module that 
are to be retained in the created nodule* Procedures that 
have been retained previously need not be respecifled In 
this parameter* 

omit or : 

(optional) This parameter specifies the externally declared 
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names In the component raodutes whose definitions are to be 
rewoved from the output module. 



star ting.procedure or sp s 

(optlonall This parameter sped f I es the external ly declared 
na«?€ of the procedure at which execution Is to begin. 
Omission causes last transfer syiibol encountered to be 
used. The starting procedure is always retained In the new 
9)0 du I e« 



upon or up i 

This parameter specifies the file to contain the created 
module and the user name In whose catalog the file is to be 
pi aced. 

base or b or baseiib or bt : 

(optlonall This parameter specifies a file of object code 
modules that the upon file will he added.! SES procedure 
GOF will be called If the keys b or base or just a file 
name is specified* 6QL will be called If the keys baseiib 
or bl are specified. 60F and GUI use the upon file as 
input and the base is rewritten with the created module as 
the last mdodule. 



lock or nolock : 

(optional) These parameters determine whether the library 

update process Is interlocked against simultaneous updates. 

Coding a filename for the lock parameter determines the 
name of the interlock file. Interlocking is the default 

action when the upon file being updated Is In another 
user^s catalog. 



output or out i 

(optional) This parameter specifies the file name to which 
an object map of the newly created lodule is to be written. 



Ipf 



(optional) This parameter specifies the file name of the 
file which contains the above oaraneter's as commands to 
BIN068K. This file must be local to your job. The 
following parameters and their optional names may be 
specified on this files (FILE, MaOILE* OMIT, RETAIN* NAME* 
STARTING^PROCEOURE). 
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£xani>tes of BIN068K Usate 

ses.bindddk f«liKyl lb>striict#f slriet cosl net tan»« • 
ftnllbll trjg^functlofis si>«staft uip«bound 

The files niylib and struct are either already local or pulled 

from your catalog. The files sine» cosine* and tan are in the 

ftnlili catalog or local. The name of the rtew module will be 

trig.f unctions and the new module will be on the file bound. 

ses«bind68k Ipfsbindlpf out«i ist upon*obotit 

where bindipf contains: 

FIL£«CFIl£lfFILE2l 

M00ULE«<MQDl>HOD2,HO03) 

RETAIM«CENTlfENTE# .. 

ENT3» •• 

ENT4f .. 

ENT5I 

NAME«N£UOHE 

SP«TEST 

END 

The ffiodules to be bound are obtained f rbn f i I es FILEl and FItE2. 
The modules bound are H001# M002 and M0D3. The entry points 
retained are ENTl ..« The new module's nan e Is NEIfONE* and the 
starting procedure Is TEST. The listing fron SIMDSSK is on file 
LIST and the bound module is on OBOUT. 
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11.4 IgM6IE-=-££l!l£EAI£.S«E££QEaS 

TRAN68K generates a file of Hotorola S records from the output 
files of the HC68000 Absolute linker. 

Parameters to TRAN68K are? 



hdr or h : 

name of the header file from the Absolute Linker. The file 
naroe has the form xxxxHOR from the ll?^k#r. This file 
contains information about the other flies needed to create 
the S records. 



srec or s s 

nasae of file to receive the S recards. 



un 



(optional) user number of catalog ta search for hdr file 
and the other files needed. The default is the current 
user. 



Exanpte of TRAN68K Usa^e 



ses.tr anbdk segoihdr srecfii 
REVERT. END TRAN68K 



This example shows TRAN68K creating srecflf fron files that are 
specified by segmtidr In the current user's catalog. 
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11»5 REEQRM68K - REFORMAT HOOULE TO H-P OajECT TEXT FORHAT 



11. 5 £££QgBMli«=-E££Q£MI«iQi}yi£.IQ^ir£-.aaiii:i.I£^i:.IflEI3iI 

REFQRH68K takes a relocatable module In the COC object text 
fornsat and converts it to the H-P foruat.? One COC file with 
relocatable object text is reformatted into tvto files Mhi ch confonu 
to the H-P format: 11 a file containing relocatable object code 
Cknoitn in the H-P world as a "reloc" type fll«)» and/or 2) a file 
containing the local syisbols for each BJodule <kfiown to the H-P world 
as an •'asmb.sym** type file)* One or both of these files can be 
generated^ as needs dictate* The reformatted faodafeCs) can then be 
downloaded for use on an H-P 64000 workstation.! This procedure will 
work on an input file with more than one nsodule.i Each module gets a 
separate record on each of the output files*^ Parameters to 
REF0RM68K are s 



input or J s 

name of file containing the nodule or modules to be 
reformatted* 



output or 3 

(optional } name of file to receive reformatted module or 
modules* If you don»t code this parameter* the value of 
the profile variable hpreloc will be used (if it exists in 
your profile)* 



synbots or sym : 

(optional) name of file to receive reformatted local 

symbols for a module or modules* If you don't code this 

parameter* the value of the profile variable hpiocsyn will 

be used (if it exists in your profile). 



un s 



(optional) user number of catalog to search for Input file* 
The default is the current user* 



userid or uld : 

a string of up to 6 characters that Is the user Id from an 
H-P development station* 



list or I 5 

a file to contain the list of warning errors from 
REF0RM68K* The default is to list warning errors to 
output* 
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Example of REFQR168K Usage 



ses«feforni68k l«€yrel yn«cyl70 o»hpfel syf«*tif>f^y« uld>hpfHe 
REVERT, END REF0RM68K CYREL -> Hf REUHPlSf 1^ 



The file cyrel is a file of COC object text in the catalog cyl70. 
The object text in H-P foriaat will be o?^ a file nailed hprel* The 
local symbols will be on a file named hplsyii.? The Mser id hpfile is 
part of the file hprel* 
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11.6 iiMI^M«=-ll£MaEX«iiM£«IiiiU£E 

BLDMI68K generates an absolute module fr'am the output files of 
the NC68000 Absolute Linker. The file specified by the htSr 
parameter is acquired by the procedure if it Is not focal. 

ParaiBeters to BL0M168K ares 



name : 

this parameter specifies the wodule name to be associated 
with the created absolute module. 



hdr or h s 

name of the header file frons the Absolute Linker. The file 
name has the form xxxxHOR from the linker^ where xxx Is the 
name seed given by the linker. This file contains 
information about the other flles^ needed to create the 
absolute module. 



output or o : 

(optional) name of file to receive the ne?* absolute module. 
If you don't code this parameter* the default file name is 
MIBMOD. 



un i 

<optional) user number of catalog to search for hdr file 
and the other files needed. The default Is the current 
user. 



Example of BtDMI68K Jsage 



ses.bldmi68k abs.module segmhdr nenmod 
REVERT. END BLDHI68K 



This example shows 8LDMI68K creatHg an absolute module named 
abs. module from files that are specified by segmhdr* In the current 
user's catalog. The new module will be on the file neiimod. 
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GENGS68K accepts as inpyt the «D8G« fifs output froiB LINK68K (the 
debug keyword roust be specified on the caM to LI1<B8K> or no *DBG» 
file Hi n be generatedy. The file is refor'nattsd Into an H^9 Linker 
Symbols Pile (also referred to in H-P manuals as a "Hnk^sym" type 
file or *»File Type 13»»)« The H-P forpatted file can then be 
downloaded for use on an H'^P 64000 wor1< station. Raraweters to 
GENGS68K are i 



input or i i 

ire<iulred) name of the linker synbols file output frojii 
LIHK68K. The file name has the forns »x)(xxOBG'> where xxx 
is the name seed used by LINK68K. 



output or o 5 

(optional) name of a file to receive the H-P formatted 
Linker Symbols File. If not specif iedf SENGS68K writes to 
a local file named HPGSYM. 



userld or uld : 

(optional) 1-6 character H-P usar^ id. This is the same id 
entered on the HP64000 in response to the userld prompt. 
If defaulted^ the then current H-^ userld will be used 
when the file is used on the H-P station. 



un 



(optional) user number of cataloti to search for the input 
file. If not specified^ the default is the current user. 



Example of 6ENGS68K Usage 

ses«gengs68k i'Junedbg uid^hpld 

REVERT. END GENGS68K JUNEOBG -> HP5SY?1 

In this example* the file named Junedbg Is a file of linker 
(i.e.* global) symbols; the H-P formatted linker sy^nbo Is will be on 
a file named hpgsym and the user id •hpid* Is recorded In that file. 
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11.8 £yMiaMll.r-£y£iS£^iIMSfli«IiSi£l 

RURSYM68K reflioves debug symbol tables* gariertted by CYBIL/CH or 
the MC68000 assembler* from modules o^ object files or object 
libraries* The input files are acquired by the procedure and the 
output files are rewritten as per iwanent f I les.l The sawe number of 
fifes sust be specified for both the Input and output parameters* 

Parameters to PURSYM68K are s 

I nput or i s 

name of file or list of files containing debug syi«bol 
tables* These files are acquired If they are not local* 
These files can be object files or* object libraries* 

output or of 

naiae of file or list of files that do not contain debug 

symbol tables Mhen this procedure is finished* All these 
files are rewritten Into the catalog of the user number 

specified* If the Input file Is an ob ject f i le> the output 

file will be an object file and the same holds true for 
object I Ibrar I es * 



un 



{optional) user number of catalog to search for input files 
and where to rewrite the output files* The default Is the 
current user* 



Exaiaple of PURSYN68K Usage 



ses*pursym68k (exec Monitor) (cexe mntrl 
REVERT. END PURSY«68K 



This example shows PURSYM68K removing debug symbol tables from 
modules on the file exec and putting the modules without symbol 
tables on the file cexe. The same is done with monitor and mntr. 
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11.9 IEMI2IUa«r>IIiiSiAII«M.lifi£4&l£i 

TRAN0ILI8 packs object laodules on object files or object 
libraries into byte oriented data ma?>^lngs so the new file or 
library can be donnloaded to the DI box. The object ntodales will 
appear to have been generated by CYSIt on the C130. The number of 
input files specified must be the same as the number of output files 
specified. 

Parameters to TRANOILIB are t 



input or is 

name of file or list of files to be translated. These 
files are acquired if they are not local. 



output or : 

name of file or list of files that have been translated 
when this procedure is finished.! All these files are 
rewritten into the catalog of the user nuiiber specified. 



un : 



(optional) user number of catalog to search for Input files 
and where to rewrite the output ^iles. The default is the 
current user • 



file or f or lib or I J 

(optional) li^i specifies the format of t^e output files. 
If you code 1 1 b» then a module directory and an entry point 
directory are included In the output files.? If you don't 
code either Kfix* then the default Is fife. I 



Example of TRANOILIB Usage 

ses.trandillfo (ob jf 1 1 1 obji ibi) (objfll? obJfll3) 
REVERT. ENO TRANOILIB 

This example shows TRANOILIB packing all the object modules on 

the object file* objfiil* and the object library* objilblf into 

packed object files objfllZ and objfll3. If you had specified lib 

or I instead of file* objfii2 and objfilS would have been packed 
1 1 br ar i es. 
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12,0 y£iQ^££Qa£-£MMiESMli£MI 



This chapter describes the SES ut i H ties for' tisl ng the UCSO Pcode 
Environraent • Facilities described In this chapter are t 



REFQRHP reformat module to UCSO Pcode object text fornfiat. 
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REFORM? takes a relocatable wodule in the COC object text format 
and converts it to the UCSD Rcode format.^ The re-for^atted woduie 
can then be downloaded to a UCSO Pcode Version IV.O P-system. This 
procedure will work on a file with ^nore than one module. Each 
module gets a separate record on the outPurt file. Parameters to 
REFORM? are : 



Input or I 5 

naise of file containing the nodule or modules to be 
reformatted. 



output or o 3 

name of file to receive risformatted module or modules. The 
default name Is PFILE. 



un 



(optional) user number of catalog to search for input file. 
The default is the current user. 



Exaaiple of REFQRHP Usage 

ses.reformp cyrel pflle unscyl70 

The file cyrel Is a file of COC object text In the catalog cyl70. 
The object text in UCSO Pcode format will be on a file named pfile. 
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13,0 5£S-aii£CI-£ai2£»MIlilIIII 



The Object Code Utilities are a collection of cofuwands *thlch ysed 
to create and update 1 1 br ar i es# modify certain aspects of indivlduai 
modules* and list various types of information for each module* The 
utilities accept as input object modules In loader' text format V1.4 
generated by cross compilers and assemblers executing on CYBER 170 
{ASM68K# CVail-CI* CY8It-Cf1 and PC00E3. Hers is a brief summary of 
the Object Code Utility comiaands. The full descriptions follow* 

COH Change Qbject flodule* Changes characteristics of a 

module in an object library. 

OEOH Q£lete Qbject tloduleCs) frosn an object library. 

OIOH display Qbject Hodulels) Information. 

60L Senerate Qbject Library. Generates or updates an 

object library. 

GOF generate Qbject file. GOF is slnMar to GOL* except 

that GOF produces a file which is not a library* 

OBJLIST displays CDC object text in a readable form. 
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This section introduces the paraweter naming convention common to 
roost of the procedures In the SES Object Coda 'JtiHtles. 

file or library naise of the object library Cor file) on 

which the object ?isodtiles reside* 

module naiae of a fiiodiile or range of modules 

upon nawe of ne« library ior file) for those 

procedures which update a library lor 
file)* 



listing nawe of fife to receive llstin 

lnfor?«ation* 
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The variables described below may be declared in your PROF HE In 
order to establish default information for* tlis oaratneters of the SES 
Object Code Utilities procedures* 

loicnode used by all of the procedures that update libraries* to 
determine the default Interlock action.^ fiokmode may be set 
to one of •LOCK* or »N0LOCK«« See also the sections below 
on updating libraries and inter locKl ng« 

intrlolc used by all of the procedures that update libraries to 
specify the interlock file to be used during the update 
process* The default naise for this file Is Intrlok* 
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When updating a Ifbrary you can Interlock the update so that only 
one user at a time can update tlie library* Those procedures that 
update a library are set up so that If the library to be updated is 
in another user's catalog* the library Is Interlocked by default. 
You can override default actions by defining n lokinode variable In 
your profile* or by coding a lock or nolock? i£gx on the procedure* as 
shown in the diagram on the next page* 

Interlocking of a library Is done via an Inter'lock file. Such a 
file liist be a filgiCI access file i0 iljg SllS USStlS CJtJisa JS tiiS 
LikLMtX kfiiaa U.S.d&t&d» Naturally the interlock file must be a 
PUBLIC* WRITE MODE file if other users are likely to be using it. 
The default name used by the SES Object Code ytllltles and library 
inanagejBent procedures for the lock file Is intrlbk^f You can have an 
Interlock file of any name by defining the Intrlok profile variable* 
or by coding a file name as a value for the lock par aieter on the 
appropriate procedures. 
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lock 



i^iiaa Ill£§a 



Mbrary or base is. locked raga 
iokiiiode profile variable or ot 



r'dfess of contents of 
her cond i tlons* 



noiock 



library or base is aai locked 
of loknode profile variable or 



regardless of contents 
other condi t lons» 



tiaiMioa 



Cail£i iQ tL^ikis. 



4sLiaa l^t&u 



\ lokiiiode»»tOCK« 



i library 
« unless 
« parameter 



or base ii locked 
overridden by noiock 
on procedure. 



\ lokiiode««NOlOCK« 1 library o 

I unless 
5 parameter 



r base is aai locked 

V er r i d d en by I ock 
on procedure* 



tiililliasL 






Current User 



+-' 



Another User 



4&ti$in Illl£a 



library or base is aai 
locked unless the lokiRode 
profile variable Is set 
to 'i3CK« or the lock 
para'seter Is coded on the 
pr ocediir e»l 



library or* base is locked 
unless the loknode 

or of lie variable is set 
to 'NOLOC<» or the noiock 
parameter is coded on the 
procedure 



^-.. 
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13.1 CON - CHANGE OBJECT MODULE 



1 3 . 1 £Qa-.z.£liAli£i-QMI£I-.BQI2yL£ 

COH Changes an ObJe<Jt Module in an object lltirary* Various 
characteristics of the module may be chaf^ged* such as entry point 
names which may be substituted or removedt <jited entry points may be 
designated or removed* and commentary may be changed. Parameter to 
COH are s 

fMe or f or library or lib 5 

name of file (or libraryl containing the module to be 
changed* plus an (optional) user riams specifying the 
catalog where the file (or 1 1 br ary) r as 1 des If it Is not in 
the current user*s catalog. The soeclflsd fife may or may 
not be a library* but if the keyword used is lib or 
library* It must be a library. Heather the upon file is a 
library is determined by the format of this input file* If 
you code a file name aHil a user nane* they must appear as a 
list* the first element of which Is the name of the flie* 
and the second element the name of the user in whose 
catalog the file resides* for example 2 f«Cdate# palm) to 
get file date from the catalog of user pallii. 

modui e or mo : 

name of the module in the library to be changed. 



nn 



(optional) name which replaces the name of the specified 
module. 



s i 

(optional) entry point pairls) whose names are to be 
substituted. The pairs are of the form (<old entry 
point>*<new entry polnt>) where <o1d entry point> is 
replaced by <new entry point>. 

omit or : 

(optional) entry point(s) whose definitions are to be 
removed from the output module. 

gate or g : 

(optional) entry point(s) that nrs to be gated in the 
output module. Sated entry points can be entered from any 
ring within the files call bracket. 
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ng • 



pro 3 



Coptional) entry pointCs) for which the gated attribute is 
to be rewoved. 



(optional I entry point at which execution Is to begin 
(transfer syaibol). 



cofliiiient or co : 

(optional! contents of the coiwiner^tar y f lei d in the module 
header* 



upon or up : 

naflie of file to receive the updated file (or library)* plus 
an (optional! user nai»e in whose catalog the file (or 
library) resides* if the file (or* library) Is not In the 
current user's catalog* Whether the uf>on file Is a library 
is determined by the format of tha Inout file* If you code 
a file name jsii a user name# they nust be coded as a list* 
the first element of which Is the name of the file* and the 
second element the user name in whose catalog the file 
resides* If you just code the file name and no user name* 
the upon file is placed in the catalog of the current user* 
If the user name refers to another* user'*s catalog* the upon 
file iMiJt MlL&^il filiSi in that user's catalog. 

lock or nolock : 

these (optional) parameters determine whether the library 
update process is interlocked against simultaneous updates; 
coding a filename for the lock oarameter* determines the 
name of the interlock file. Interlocking Is the iljljult 
action when the library being updated Is In another user's 
catalog. If you don't code either of ttie lock or nolock 
IsjSXS' Interlocking is controlled by the foknode profile 
variable. Refer to the intr oductorV sections of this 
chapter for Information on the interactions of the lokmode 
profile variable and the lock and nolock parameters. If 
you don't code a filename for the f«>ck parameter* the 
contents of profile variable Intrlok Is used as the 
interlock filename* if there's no such profile variable* 
the name intrlok Is used as the lock filename. The 
interlock file liisl be in the sane catalog as the library 
being updated. If the interlock file cannot be found* the 
procedure aborts* 
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ms§ or no«sg : 

ttiese <optionan li£3tS. control? tNe generation of 
informative messages by this procedure and are fully 
described in the section entitlad «T^F3RHATIV£ HESSA6ES 
FRQH SES PROC£OyRES«. 



Examples of CON Usage 

ses.com I ibrary*! i&l nodule«modx nn*mody uPon«fib2 
REVERT, MOOUtE MOOX CHANGED ON FIIE LI92 

This command creates a new library^* Mb? vthlch Is identical to 
library llbl except that the name of nodx Is changed to nody. 

ses«com f i I el modx s^fCeplf netfepl)» leo?» ne««ep2l I up* I f i le2#Mrbl 

♦ LOCKING FIiE2 VIA INTRLQK 

♦ FIL€2 LOCKED 

♦ FILE2 UNLOCKED 

REVERT, MODULE MODX CHANGED ON FILE FILE? 

This command creates a new file flle2 day be library) Identical 
to fllel except that entry point name neweal real aces epl and fieMep2 
replaces ep2. The destln6ation file* fHe2 Is given with the user 
name wrb* so the automatic interlocking ur'ocess takes place during 
the update of fiie2« 

ses«com libl no^modulex o«entl g«ent2 ng«ent3 prb«ent4 •« 

♦ •? co«*cpu migds rev Jew* up»ilb2 

REVERT, MODULE NOOULEX CHANGED ON FILE LIB2 
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DEOli 0£let8s Object |lodule(sl or ranges of a^jject modules from an 
object library. Parameters to DEOH are ? 

file or f or library or lib s 

name of the file (or library) tram which inodufe(s) or 
module subrange(sl are to be deleted* plus an (optional) 
user nai«e in whose catalog the file or* library resides if 
It lsn*t in the current user's catalog. « TTie specified file 
may or f»ay not be a library* but if the key*iord used Is lib 
or library* It «iust be a library, irfhather the upon file is 
3 library Is determined by the for?i»at of this Input file. 
If you code a file name go,^ a user' na^e» they must appear 
as a I Istf the first element of >fhich is the name of the 
file* and the second element the name of the user in whose 
catalog the file resides* for exaTipfe s f«fcoconutf palm) 
to get file coconut from the catalog of user palm. 

module or mo : 

moduleCs) or module subrangefsl to be deleted from the 
file. If a specified module Is not on the file* a fatal 
error is issued. 



upon or up t 

name of the file Cor library) or\ which the remaining 
modules are written* plus an (optional) user name in whose 
catalog the updated file (or library) Is to be placed* if 
it is not in the current user's catalog. Whether the upon 
file is a library is determined by the format of the input 
file. If you code a file name aJaJ a user name* they must 
be coded as a list* the first element of which is the name 
of the file* and the second element the user name in whose 
catalog the file resides. If you Just code the file name 
and no user name* the upon file Is placed In the catalog of 
the current user. If the user lame refers to another 
user's catalog* the upon file j'ijsj; iltg'j'Ji SXilJt ^n that 
user's catalog. 



ock or nolock : 

these (optional) parameters determine whether the library 
update process is interlocked against simultaneous updates; 
coding a filename for the lock parameter' determines the 
name of the interlock file. Interlocking is the isfauit 
action when the library being updated Is in another user's 
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catalog. If you don't code either of tNe locic or nolock 
litXS.* Interlocking is controlled by t^e lokmode profile 
variable* Refer to the Introductory sections of this 
chapter for Information on the Interactions of the lokmode 
profile variable and the lock and nolock parameters. If 
yoy don't code a fllenaJie for* the lock par ainetert the 
contents of profile variable Ifitrlok is ysed as the 
interlock fllenafnej if there's no stich profile variable^ 
the name intriok is used as the locki filename. The 
Interlock file lusi ^^ ^'^ the saie catalog ^s the library 
being updated. If the interlock file cannot be found* the 
procedure aborts. 

listing or list : 

(optional) name of listing file on vfhich the names of the 
modules on the new library are listed In the order in 
which they occur as well as the fife frhm which they came. 
If yoy don't code the list parameter* no '•listing* output 
Is produced. 



lasg or nonsg t 

these (optionall kfilS. control the generation of 
informative messages by this procedure and are fully 
described In the section entitled «INFORHATIVE MESSAGES 
FROH SES PROCEDURES'*. 
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Exafupies of OEOH Usage 

ses*deoiii libraryiibl nodule^nodx upon*Hb? 
REVERT. HOOUIES DELETED ON FILE LI82 

This comraand creates a library I Ib2 idsitl cat to Hbl except that 
nioduie modx is deleted* 



ses.deon file«Cfilel# userll flio«(iiioda*^liodb»liodcl up«fiie2 
REVERT. HODULES DELETED ON FILE FILE? 

This command creates a file file2 (Is library If fllel is 
library) Identical to file! except that i^dules between noda and 
»odb Inclusive and mode are deleted* The file %or library) fllel Is 
being obtained from the catalog of userl* 
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13.3 M£m-=-.i}ii£L AI-.SIii£I-ll0fiyL£-I!i£QEM4nil 

OIOH displays varloys pieces of Irif or taatJon about Qbject 

ioduieCs) in an object library* The fomat of the list file 

produced is described in the object code utilities ERS CARH2922). 
Parameters to OIOM are s 

file or f or library or lib i 

name of file (or library) whose contents are to be 
displayed* plus an Coptional) user* nane in whose catalog 
the file Cor llbraryl is to be found* if It is not in the 
current user's catalog. The specified file way or may not 
be a libraryf but if the keyword used is lib or library* it 
pust be a library. If a file Cor library) na«e jQi a user 
name is coded* they must appear as a list* for 
exawiple i Hb«loffthe* wall) to get 1 1 br ar y of fthe from the 
catalog of user wail. 

nodule or mo s 

Coptional) sioduleCs) or module subrangeCs) about which 
information is to be dlsplaysi. If a subrange is 
specified* all inodules in the subrange are displayed. 
Omission causes all modules in the file or library to be 
d ispl ayed. 

1 isting or list : 

Coptional) name of file on which the display inforiRation 
is to be written. Omission causes the Information to be 
written to the job output file. 



on 



Coptional) level of information to be displayed. Only the 
options selected are in effect, ^alld specifications are: 

time and date module was created 

£ entry point definitions of the nodule 

H module header information 

X externai references made by the module 

A all information printed by 0* E* H and X (default) 
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Exaaples of OIOH Usage 

ses*<lioiii iibrary«libl noduiesfiodx Ilst«l1stx oripa 
REVERT. HODULES FRQH FILE LIBl OISPlArEO 

This cojnaiand lists all inforwation about module i»odx of library 
libl on file llstx. 



ses*diom file»<fi iex»losery1 «o«(iiioda«^litodb»fliodcl on*{d9h»xl 
REVERT. MODULES FROH FILE FILEX 0ISf>LAYE9 

This command lists date and time created* module header 
Inf ormation* and external references about modules moda to modb 
inclusive and J»odc of filex <may be MbrarW on file output 
Cdefayitr* The file fIlex is acquired fron the catalog of user 
losery* 



13-14 
COC - SOFTWARE ENGINEERING SERVICES 

18 December 84 
SES User's Handbook REVs 4A 

13.0 SES OBJECT CODE UTILITIES 
13.4 GOi - GENERATE OBJECT IIBRART 



GOL £erierates an flbject Library* or updates an existing object 
library* Aisof several flies can be combined into one* GOL 
requires that there be an input file specified either by the file 
parameter* or base parameter • 

The add* replace* and combine parameterst sped fy exactly Hhich 
modules from the flleisl specified by the ffl% para?neter to Include 
on the new library* while the after and beforle Parameters control 
the position of the nen fnodufes* Parameter's to GDI are J 

file or f or library or lib 3 

(optional) list of f i I ename-usernaiie »alrs describing files 
Cor libraries) from which object nodules specified by the 
following three parameters are to be obtained for the new 
library* The specified filaCs) nay or may not be 

llbrary(s)* but If the keyword used Is lib or library* they 
must be llbraryCs)* Each elemerit In the list of file Cor 
I I brar yl names can either be a single file Cor library) 
name* stL the element can itself be a fist of two elements* 
the first Is the file (or library) name* and the second Is 
the user name in whose catalog t»ie file Cor library) 
resides* If only a single element* file Cor library) name 
is given* the file Cor librarVl Is acquired from the 
current user's catalog* 

The next three parameters Ccombine* add* and replace) specify 
moduleCs) or module subrangeCs) to be included on the new library 
from the files specified by the file or library parameter* None* 
one* two or all three parameters may be specified* If none are 
specified* all the modules on the files specified by the file or 
library parameter Is Included on the new library** Only the first 
occurrence of duplicate modules are Included in the new library* 
As explained below* the particular parametert s ) used give you 
control over whether the given modules should exist on the base 
I ibraryCs )* 

combine or co : 

Coptlonal) moduleCs) to be included In the new library* 
The specified moduleCs) may or lay not exist on the base 
tibraryCs)* If they exist* they are replaced* 



add 



Coptional) moduleCs) to be AOOed on the new library* If a 
specified module duplicates a module already on a library 
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specified by the base paraifteteff a fatal error Is Issued* 

replace or tbp s 

Coptlonall woduleCs) to be REPLACEd ori the ne^ library. 
If a specified module does not alf'eady exist In a library 
specified by the base parameter* a fatal error Is Issued* 

after or af or before or be s 

loptlonall fflodule on a base library after* or before which 

to position the nen iRodules. Default position Is after 

the last iBodule on the last base library.! 

base or b or baselib or bl : 

(optional) list of f I lename-userna^e oalrs that determine a 
list of base file(s) or llbrarV(s) to be included In the 
new object file* All modules from the base files (or 
libraries) become part of the new object file except 
duplicate modules (the first occurrence of the module takes 
precedence}* The specified filefs) may or may not be 
llbraryfsl* but If the baselib or* bl keyword Is used to 
code the parameter > they mus,t be llbraryCs). Each element 
in the I Is t of files (or I I br ar ies) can Itself be a list of 
two elements* the first being the nane of the file Cor 
library)* and the second being the nane of the user In 
whose catalog the file (or library) resides. If only one 
element Is specified* the file (or* library) Is acquired 
from the current user^s catalog* 



upon or up : 

name of file to receive the generated object library* plus 
an (optional) user name In whose catalog the new object 
library is to be placed* if It is not In the current user's 
catalog* If you code a file name aa^jrl a user name* they 
must be coded as a list of two elements* the first of which 
Is the file name* and the second the user* name* If you 
just code the file name* the upon file Is placed In the 
current user's catalog. If the user name refers to another 
user's catalog* the upon f 1 1 e liist aitaai^ fiiLi&t I" that 
user's catalog* 



lock or nolock : 

these (optional) parameters detemlne whether the library 
update process Is Interlocked against simjitaneous updates; 
coding a filename for the lock oarameter' determines the 
name of the interlock file* Iiterlocklng Is the il^ljiili 
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action Mhen the library being updated is in another user's 
catalog* If you <lon«t code either of the lock or nolock 
\i§l^* interlocking is controlled by the lokttode profile 
variable* Refer to the introductorV sections of this 
chapter for Inforisation on the Interactions of the lokmode 
profile variable and the lock and nolock parameters* If 
yoy don*t code a filename for the flicki parameter* the 
contents of profile variable Intrlok Is used as the 
Interlock filename^ If there's no such Profile variable* 
the nawc Intrlok Is used as the lock filename* The 
interlock file luiLi be in the saijs catalog as the library 
being updated* If the in terl ocki f I 1 e cannot be found* the 
procedure aborts* 

listing or I ist : 

(optional) na»e of listing file on which the names of the 
modules on the new library are listed in the order In 
which they occur as well as the file fro?B which they came* 
If this parameter is not specified* no "Usting** output Is 
produced* 



msg or nomsg : 

these {optional) lifiXS. control the generation of 
informative messages by this procedure and are fully 
described in the section entitled '•I?4F3RHATIVE MESSAGES 
FROM SES PROCEDURES"* 



ipf 



(optional) parameter specifies that the other parameters 
may be specified on a local file*! The parameters which 
may be specified are: FILE* COMBIME* ADO* REPLACE* 
AFTER/BEFORE* and BASE* The parameters are specified on 
the file the same way they are specified on the command 
I ine* 



Examples of GOL Usage 

ses*gol f i I e«|{coconut*palffl) ) I i $t«roc)(!er upon«fiewllb 

REVERT* OBJECT LIBRARY GENERATED 

This command creates a library newllb ifhich contains all the 
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modules frois file coconut (may be librarylf obtained from the 
catalog of user patn. Display Informatior^ aopears on file rOcker* 

ses«gol iib«inplib add^aioreof rep'sanieas bf»baselib up«neiffib 
REVERT. 0B4ECT LIBRARY GENERATED 

This coflsfliand creates a library nenllb Idsfitlcal to library 
baselib except that module saneas from library inpllb replaces 
sameas and module moreof from inplib is add«;d at the Qn4m Display 
inforfflatlon appears on file output Cdefaultl. 

ses«gol base«lf i I el^f i Ie2f f 1 1 e3l upon«nevft lb 
REVERT. OBJECT LIBRARY GENERATED 

This command creates a I ibrary neiil ib '*ihrch Is the combination of 
libraries fllel» file2 and file3» all obtained from the current 
user's catalog. Only the first occurrence of duplicate modules 
appears on the new library. Display information appears on file 
output. 

ses.gol ff i lea>f i lebl co«{tea«.dinnef »nl teeapl after«lunch •• 

••? base«basetib up«nova 

REVERT. OBJECT LIBRARY GENERATED 

This command creates a library nova usiif IfbrarV baselib as a 
base. Hoduies tea thru dinner inclusive and nitecap from flies 
filea and fiieb Imay be librarieslf both obtained from the current 
user's catalog^ are added after module Itineh. Olsolay Information 
appears on file output. 

ses.gol lpf«goripf llst«listf upon«neii 
•DATA>GOLLPf. 
FILE«rFIL£l# FIL£2> 
C0NBINE«IN001..N0D3I •• 

N0D6 
BASE«NYBASE 
(EOR) 

This command creates a library nett by combining files FILElfFILE2 
and the modules N0D1..N0D3 and N006. The base file is NYBASE. Note 
that the parameters are obtained from GQLL'^F'. 
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13.5 £0£.r«iIli£ElI£.QM£ai«£ii£ 

GOF generates an Qbject £rie# or updates an existing object file. 
Also* several files can be combined inta one. GOF requires that 
there be an input file specified either by the fllie parameter* or 
base parameter. 

The addf replace* and combine par awetersf speci f y exactly which 
modules froiR the fileCs) specified by the file p3ra!aeter to Include 
on the new object file* while the after and before parameters 
control the position of the new modules. Parameters to GOF are t 

file or f or I i br ar y or lib s 

(optional) list of f i I enanie-user?ia^e oairs describing files 
Cor libraries) frosj which object modules specified by the 
following three parameters are to be obtained for the new 
object file. The specified flleCs) nay or way not be 
libraryCs)* but if the keyword used Is lib or library* they 
iisust be libraryCs). Each elemefit in the fist of file Cor 
library) names can either be a single fife Cor library) 
name* nt the element can itself be a list of two elements* 
the first Is the file Cor library) name* and the second is 
the user naae in whose catalog the file Cor library) 
resides. If only a single element* file Cor library) name 
is given* the file Cor library) is acquired frora the 
current user's catalog. 

The next three parameters Cconblne* add* and replace) specify 
raoduleCs) or module subrangeCs) to be Included on the new object 
file from the files specified by the fife or library parameter. 
None* one* two or all three parameters nay be specified. If none 
are specified* all the modules on the fllfes soeclfled by the file 
or library parameter is included on the new object file. Only the 
first occurrence of duplicate modules are Included In the new 
object file. As explained below* the particular parameter Cs) used 
give you control over whether the given nodules should exist on 
the base libraryCs). 

combine or co s 

Coptional) moduleCs) to be Included In the new object 
file. The specified moduleCs) nay or may not exist on the 
base libraryCs). If they exist* they are replaced. 



add i 



Coptional) moduleCs) to be AOed on the new object file. 
If a specified module duplicates a nodule already on a 
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I Ibrary speci f I ed by the base paraiteteff a fatal ^rror is 
i ssued* 



repi ace or tbp ? 

CoptionaU rooduleCsJ to be RE?*lACEd on the new object 
file. If a specified module does not already exist In a 
library specified by the base parameter* a fatal error Is 
I ssued. 



after or af or before or be s 

(optional) module on a base library after* or before which 

to position the new modules. Default position Is after 

the last module on the last base library.! 



base or b or baselib or bl s 

(optlonail list of f i lenajae-usernaie oafrs that determine a 
list of base file(s) or llbrarytsl to be Included in the 
new object file* All modules friii the base files Cor 
libraries) become part of the new object file except 
duplicate modules (the first occurrencs of the module takes 
precedence). The specified flleCs) may or may not be 
library(s)# but if the baselib or bf keyword is used to 
code the parameter* they ims.! he llbrary(s). Each element 
in the list of files (or libraries) can Itself be a list of 
two elements* the first being the name of the file (or 
library)* and the second being the name of the user In 
whose catalog the file Cor library) resides. If only one 
element Is specified* the file Car library) Is ac^iuired 
from the current user's catalog. 



upon or up : 

name of file to receive the generated object file* plus an 
(optional) user name In whose catalog the new object file 
is to be placed* if It Is ^ot In the current user's 
catalog. If you code a f i le name aa^ a user name* they 
must be coded as a list of two elementst the first of which 
Is the file name* and the second the user name. If you 
just code the file name* the upon file Is placed In the 
current user's catalog. If the user name refers to another 
user's catalog* the upon file 2!ISl altaadx fixist in that 
user's catalog* 



lock or no lock : 

these (optional) parameters deterilne whether the library 
update process is interlocked against simultaneous updates? 
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coding a filenarae for the lock par'af^eter* determines the 
nawe of the interlock file. iTterfocklng is the iifi£aiiii 
action when the library being updated Is in another user's 
catalog* If you don't code either of the loclc or noioci( 
llSXi* interlocking is controlled by the loknode profile 
variable* Refer to the introductory sections of this 
chapter for information on the interactJofis of the iok«ode 
profile variable and the lock arid nofock parameters* If 
you don't code a filename for tlia lock parameter^ the 
contents of profile variable Intrlbk Is used as the 
interlock filename; if there's no such oroflle variable* 
the name intrtok Is used as the lock filename* The 
interlock file iMsi be In the sane catalog as the library 
being updated* If the interlock file car^not be found* the 
procedure aborts* 

I isting or I ist t 

{optional) name of listing file o'>M4hich the names of the 
names of the modules on the new library are listed In the 
order in which they occur as well' as the file from which 
they came* If this parameter Is not specified* no 
"listing" output Is produced* 



rasg or nonsg i 

these (optlonail ISSXi control the generation of 
informative messages by this orbcedure and are fully 
described in the section entitled "IMFORMATIVE MESSAGES 
FROH SES PROCEDURES"* 



Ipf 



(optional) parameter specifies that the other parameters 
may be specified on a local file. The parameters whclh 
may be specified are: FItE> CO^iBINEt ADD* REPLACE* 
AFTER/BEFORE* and BASE* The parameters are specified on 
the file the same way they are specified on the command 
I ine* 



Examples of GOF Usage 

ses«gof f i le«C(f i iex*usx)*(f 1 ley*usy)) list* I Istx up«netif i le 
REVERT* OBJECT FILE GENERATED 

This command creates an object file newflle which contains all 
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the iRodules from the object files fifex (obtained ffom the catalog 
of ysx) and f I ley (obtained froia the catalog of iisy). File filex 
and flley can in fact be library(s). Display Inforiwation appears on 
file If six. 



ses«gof lib«inplib add«iRodl rep«iiod2 b«basel1b up«lnf iletnysrl 

* LOCKING MEMFILE VIA INTRLOK 

* NEMFILE LOCKED 

* NEWFILE UNLOCKED 

REVERT. OBJECT FILE GENERATED 

This command creates an object file fifMe Identical to library 
basellb except that module Biod2 from library Inptlb replaces iiodZ 
and inodyle modi from Inplib is added at the end. Note that file 
nfile is specified as being In the cataloi? of ntisff so the object 
library update is autoi»ati cal I y Interlocked. Display information 
appears on file output (default). 

ses.gof base«Cf i lelff i te2#f i le3l upon«latest 
REVERT. OBJECT FILE GENERATED 

This cowmand creates an object file latest which is the 
combination of libraries fllel» file2 afid fHe3. Only the first 
occurrence of duplicate modules appears on the new library. Display 
information appears on file output. 

ses.gof (f i leaf f I leb) co«(noda..nodb»«odcl after*«Riodx «• 
#•7 base«(Cbaselib90iduserl) yp*neiiobjf 
REVERT. OBJECT FILE GENERATED 

This command creates an object file nenobjf using library basellb 
(obtained from the catalog of olduser) as a base. Modules moda thru 
modb inclusive^ and mode* from flies fitea and fileb (may be 
libraries) are added after module modx. Display information appears 
on file output. 

ses.gof lpf«gollpf fllst«listf upon»nei« 

.OATA#GOLLRF. 

FILE«(FILElfFILE2l 

C0NBINE«(N0D1 «• H003) .. 

N0D6 
BASE-MYBASE 
(EOR) 

This command creates a file NEW which is a combination of FILEl and 
FILE2 and the modules MODI .« MQD3 and M306. The base file Is 
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NYBASE. Note that the pararRetsrs are obtalf^ed frou GOLtPF. 
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The action taken by 08JLIST Is determMed by tf?e DEBUG parameter. 

QBJLIST will either print out CDC object text in a readable form or 

produce a symbol table file for use with the CYBE^ 180 simulator. 
Parameters to OBJLIST are : 



I or f 



o 5 



debug 



(optionaU name of Input £lle which Is to have Its contents 
listed out. If you don't code the I pararoetert OBJLIST 
assumes the object text is on file I go. 



ioptionall name of file to receive the Qutput from OBJLIST. 
If you don't code the o parameter^ the output appears on 
file output. 



(optional) iLfix determines whether' OBJLIST pr ints COC object 
text in a readable form or produces a synbol table file* 
If you code the debug ^&t* OBJLIST produces a symbol table 
file. If you fail to code the debug lsgi# OBJLIST produces 
a readable listing of CDC object text*! 



Examples of OBJLIST Usage 



ses.objilst o«tlsting 

REVERT. END QBJIIST LGO -> LISTIfIS 



ses.objilst i«blnaryf o«prinfyi 

REVERT. END OBJLIST BINARY -> PRI^FYL 
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14.0 SQy£££.£Qa£^yiIUII-i3M.MQS-i2a 



SES provides a series of procedures for access to the NOS 170 
prototype i rapleaientat ion of the Source Code Utility. The procedures 
currently available In this category areJ 

SCU Acquire the executable binary for SCU. 

SOiO Run the SCU editor In stand alone ^ode.i 

SCUCOHP Generate an SCU modification for a deck. 

EOSCU Edit a deck froii an SCU library. 
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14.1 SCU --ACQUIRE EXECUTABLE BINAI^Y FOR SCIJ 

SCU ac<iulres the executable binary for the Source Code Utility 
and copies it to a local file named SCU* I;^ response to calling 
this procedure the user may be sent a short lessacie warning him that 
a change has been introduced and t?iat there Is additional 
information available through the STATUS facility* There ^re no 
paraiaeters for the SCU procedure. 

The library CYBCCHH or CYBICHN which contaifi declarations for 
interfaces supported by the SES group ^ay be accessed in the form of 
SCU source libraries through the use of the SETCOHS procedure. 
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14*0 SOURCE CODE UTILITY ON NOS 170 
14,2 SOLO - STAHO ALONE SCU EDITOR 

SOLO Is a stand alone version of the SCJ editor* that can be used 
to edit any text file. A delay i«lll be encounter ed yih^n entering 
and exiting this editor because a temporary library Is created on 
entry from which the text file Is extracted on exit. Parameters to 
SOLO are s 



base or ba : 

ioptional) naswe of text file to be edited. If you don't 
code the base parameter* SOLO uses a local! file named base. 



result or r s 

(optional) name of file to receive tt^e result of the 
editing session (SOLO doesn't* by default, write the edited 
file back over the text input file specified by the base 
parameter). If you don't code the result parameter* SOLO 
writes the result on a local file named result. 

input or I s 

(optional) name of Input file frbn ^ihlch SOLO reads 
commands. If you don't code the I nput par ameter* commands 



are read from input. 
list or I 



(Optional) name of file on which the editor displays are 
written. If you don't code the list paratieter* SOLO writes 
its displays to file output. 
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14.3 SCUCQMP - GENERATE SCU CORRECTION SET 



14.3 i£yaaiE«=,.S£ii££4i£«iCLy.£aaa£CLiioii-S£r 

SCUCOHR compares an '•old*' version of an SCU deck* (obtained frow 
an SCU source library) with a *'ne«" version of the same deck 
(obtained from a ••source** file). The "source** file must have 
neither line Identifiers nor deck directives In It. The output of 
SCUCOflP is a file of SCU EDITor commands that transform the "old** 
version of the deck into the "new** version.* 

You can select a character to be used as the value of the UNTIL 
parameter on SCU EOITor INSERT and REPLACE comwan^s. The default 
character Is the hyphen. If any lines of Insertion or replacement 
text end in the '*text delimiter** character* they are followed on the 
edit coiaiaands file with a line that Indicates the probiemf and the 
NOS Job control register EFG is set to a non-zero value; otherwise 
EFG is set to zero. Parameters to SCUCOHP are s 



name or na : 

MAH£ of an SCU deck against which the correction set are 
gener ated. 



source or s 5 

name of a source file containing a fuodlfled version of the 

deck. 



ec i 



name of a file to which SCU editor commands are to be 
wri tten. 



base or ba t 

(optional) name of an SCU source library containing the 
**unraodi f i ed** version of the SCU deck with which the source 
file are compared. If you don't code this parameter^ 
SCUCOHP attempts to access a file named base. 



un 



td t 



(optional) User Name in whose catalog the source library 
specified by base Is to be found. 



(optional) single character valije which defines the 
lerminating delimiter to be used on text Insertion commands 
generated by SCUCOHP. The value of td mav be given as any 
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14,3 SCUCOHP - GENERATE SCU CORRECTION SET 



single character* or as a positive inteaer in tf»e range 
1»«127. If you don't code the td parafl^eter* SCUCOHP uses 
the hyphen - as the default character* 



is or ignofis « 

These Coptional) issii specify whether or not to ISMQRe 
Leading Spaces on lines being cofspared* The default 
action Is to recognise leading spaces fthe Is option)* If 
you code the jgnoris fifix SCUCQffP Ignores leading spaces on 
text 1 1 nes* 



Exawple of SCUCOHP linage 

ses«scycoiiip «sci»$edl tor. help^cowmand'* formed •f.t 
ecsffiodfofii ba«s 10619 

This exaiRple of SCUCONI^ corapares formatted source statements on 
file FORMED with the SCU deck SCH$E0IT3t_HEL!>L^0MMAND from the 
source library on file 310619 to build an SCU modlf I cati on for the 
deck on file HQDFORN* In this case lines differing by leading 
spaces were recognised as changed* 
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14.4 EDSCU - EDIT A DECK FRQH AN SCU lI8RA!?r 

EDSCU provides the user with a co?iveiiient way to fflake 
modifications to decks from an SCU library i»i thout having to 
directiy yse the SCU editor. The user luay use FSE» XEOIT* EDIT* or 
EDT depending on their preference. Parameters to EDSCU are s 



na or nane t 

(optional) name of deck to be edited* If yoy don't code 
this parameter* EDSCU wl 1 1 prompt you for* it unless you 
coded the end |££i and are In SCU.S?^OUP wode Csee the group 
k&l below). 



ba or base • 

{optional) name of the base where the deck to be edited 
can be found. The base paraiaeter should only be coded 
when you aren't In SCU. GROUP !!iode. If you aren't In 
SCU.SRQUP mode and haven't coded this paraitieterf EDSCU 
uses the value of the profile variable scubase* and if 
there's no such variable defied In your profile then 
EDSCU will prompt you for the base nane. 

nb or newbase • 

(optional) nanne of the new base where base is to be 
rewritten after the deck changes are cojnpfete. Default is 
to write back over the base name specified by the base 
parameter. EDSCU will not pronat you for this parameter 
so to change it you must code It on the call to EDSCU* 
This parameter can be set or changed at any time. Last 
value coded Is used when the end l£2i Is coded. 

mod or modification : 

(optional) nodlficatlon name to use when your editing 
changes are supplied to the SC'J editor. If you aren't in 
SCU. GROUP mode and haven't coded this parameter* EDSCU 
will prompt you for it. You nust code this parameter on 
the call to EDSCU to change the value while in SCU. GROUP 
mode. This parameter can be set or' changed at any time. 
Last value coded is used on subsequent calls to this proc 
until the end Ji^i is coded. 

e or editor s 

(optional) name of the editor* you wish to use. If you 
don't code this parameter* EDSCi -jses the value of the 
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profile variable editoff and if there's ^o such variable 
defined In your profile EDSCU *ill1 use F6E as the editor. 
EDSCU Hill not prompt you for this value. This parameter 
can be set or changed at any time. The last value coded 
is used on subsequent calls to this pr%c until the end jigi 
i s coded. 



9 or group : 

Coptfonal) Jssi initiating SCU.GRlilP «ode.^ The use of this 
parameter is recommended If ybur changes will be 
associated with more than one modification na?iie or your 
changes will occur in more than oie deck. This parameter 
should be coded only when you aren't already in SCU. GROUP 
mode. EDSCU assumes you are In SCU.SROlf* mode If either 
files 2Z2ZZGF or SESSCCG are locals EDSCU will not prompt 
you for this value. 



end 



(optional } issi terminating SCU.GRIJO iiode. EDSCU iiill not 
prompt you for this value. 



An Exanple of EDSCU Usage 



ses.edscu g 

ENTER DECK NAME 

? ddunp 

ENTER BASE NAME 

? testba 

ENTER HODIFICATXON NANE 

? xyzmod 

* BEGINNING EOSCU ON DDUNP OF TESTBA 

♦BEGINNING GROUP FOR TESTBA 

* XEDIT AVAILABLE 
XEDIT 3.1.00 

?? I 

? C HELLO THERE ONE AND ALL 

?? e 

ZQPQDXN IS A LOCAL FILE 

* GENERATING CHANGES FOR ODUNP 

* INSERTING CHANGES TO DDUMP 

♦'I' E SC 8004S Continue specified for unknonn nodification 

* HODIFICATION XYZMOD ADDED TO DDUMP 

* DECK ODUNP EDIT COMPLETE 
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* ENTER *SES.£OSCU* TO EDIT NEXT DECK 

* ENTER *SES«EOSCU END* IF FINISHED 
SREVERT. 

sescedscu end 

* ENDING ♦EDSCU* EDIT SESSION TEST8A — > TEST84 
$R£VERT* 

Please note that the error message t30D4) generated In this 
example can be expected if the modification naia used Is a brand new 
one. 
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15.0 SQME(I£-I£ilI-.£Sf £EOiC£iSQEl 



The utilities described In this section soiaorlse a general set of 
reforaatt ing facilities for source text* They are described briefly 
here# and more detailed descriptions follow.! 

CYBFORM a source code fornjatter for CYBIl. 

ISWLFRH a source code formatter for I54L. 

PSEUOO text preprocessor that can generate repetitive 

sequences of text. 

F5F0RII formats Fortran 5 source text. 

PASTOCYB runs the PASCAL to CYBIL source code translator. 
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15.0 SOURCE TEXT RREPROCESSDRS 

15*1 CYBFQRH - CY8IL SOURCE TEXT REFORMATTIR 

15.1 ai£QSIL.=«£X iiL-SQy£££.I£lI*E££QSaiIIil 

CY8F0RM Is a source code reforsiatter for CYSIif such that prograai 
readability and consistency of presentation are enhanced. The 
operation of this procedure differs fro*B that described in the 
CYBFORH ERS in that this procedure rewinds both the input and output 
files before and after the r ef orniattinf operation* Note that 
CYBFQRH can handle multi record files. Rar'asieters to CYBFORH are 5 



i or f 



nawe of Input File containing the CY8IL source text to be 
ref or flatted. 



(optional) naaie of file to r'eceiye the Output frofn 
CYBFORH. If you don't code the o parameter* CYBFORH 
places the output on the fife specified by the I 
P ar araeter . 
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15.0 SOURCE TEXT PREPROCESSORS 

15.2 ISWLFRH - ISWL SOURCE TEXT REF0RHATT5R 



15.2 llML£EiL.=-IlMi-iflyglII-I£lI-S££QillAII£l 



ISWLFRH reformats ISWL source code* sucN that program readability 
and consistency of presentation are enhanced. Paraiieters to ISWLFRM 
are s 



I or f : 



o : 



name of Input File containing the ISWL source text to be 
reformatted. 



(optional) name of file to receive the Output from 
ISWLFRM. If you don«t code the o parameter* ISMiFRM 
places the output on the file specified by the I 
parameter • 



Suiijti^ ai fatijtilon Qitle&tliss 



I Directives are given to the ISWL formatter' by embedding 
\ certain comment toggle options in the inaut ISm source code i 



4-.« 


«$P + »» 


IB 4. a 


Select comment formatting. 


i _ l_> 


«$?-" 


^A.m 


Turn off comment formattincj. 




"$PR" 


m. A.m 


Discard existing line numbers* If any* and generate 
new 1 Ine numbers. 


^-^-m 


«$PN« 


•»4.a 


Discard existing line numbers* If any* and do not 
generate new line numbers. 


A ,_ _ 


«$PS*« 




Preserve existing line numbers. 




«$PB»« 




Preserve existing blank lines. 


T*""" 


»%p[j» 


»^m 


Capitalize ISWL keywords. 


T*""" 
+ — 


^%n<r\>** 


->• 


ISWL Hargin chop. Formatter «raps fine around at 
N-1 character position. 



-♦ 



Default selections « "SHTZ" ••IPS" ••$?*-•• 
Mi2i£ 5 ISWLFRM assumes a syntactically correct ISWL program. 
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15.2 ISilLFRM - ISMt SOURCE TEXT REF0RI14TTER 



Syntax errors may cause undeslred results on the output file. 
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15.3 PSEUOO - RUN PSEUOQ PREPROCESSOR 

PSEUOQ is a text preprocessor which enables paraineter i zed 
repHcatlon of selected portions of a text file. T!ie parameters to 
this procedure ares 



i or f s 



* 



m : 



op 



nawe of the Input File containing! the text to be processed 
by PSEUOO. 



{optional) name of file to r*ecelye the Output froro 
PSEUOO. If you don't code the o oarasjeter* PSEUOO 
directs the output to the file specified by the I 
parameter. 



(optional) naine of file to recelvB the secondary output 
(Hessages) from PSEUOO. If you don't code the m 
parameter* PSEUOO places the Messages output Cif any) on a 
file cal led HS6S. 



(optional) nawe of the file to receive the statistics (and 

any error messages) from the run. If you don't code the 

op parameter* PSEUOO writes this information to file 
OUTPUT. 
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15«4 F$FORM « FORTRAN 5 SOURCE TEXT REFORMATTER 

F5F0RH reformats FORTRAN-5 source text to reflect the nesting 
levels of IF-THEN-ELSE blocks and 00 loops,! i^arlimeters are 2 



L or t t 

name of Input £lle containing t^e FT>I5 source text to be 
reformatted by F5F0RM. 



St : 



Coptlonal) name of file to receive the Qutput frof» F5FQRH# 
If you don't code the o paraieterV F5F0RI1 places the 
resultant formatted text on the fifa specified by the I 
parameter* 



Exanpies of F5F0RH Usage 



ses«f5forffl |smessy» o«lovely 

REVERT. END F5F0RH HESSY -> LOVELf 



ses«f5foriii modern 

REVERT. END F5F0RH MODERN 
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15.5 PAST0CY8 - PASCAL TO CYBIL TRANSLATOR 

PAST0CY8 runs the PASCAL to CYBIL sourca code translator. This 
translator is based on the University of Minnesota PASCAL coaipiler* 
It perforins syntax checking on the source Input and till I translate 
Incomplete decks* although complete source input files produce the 
best results. Note that this translator may not work for all of the 
many existing dialects of PASCAL. 

The procedure is arranged so that It i^lfl not abort. If source 
code conversion errors are encountered* the NOS Job Control Register 
called EFG is set to a non-zero value upon exiting the procedure. 

Parameters to the PASTOCYB procedure are * 

i or f 5 

Cre<|ui red) name of PASCAL source Inout file. 



(optional) name of the output file to receive the CYBIL 
source code produced by the translator. If you don't code 
the parameter* a file named CY3FIL5 Is used. 



I s 



ml : 



(optional) name of the file to receive the listing 
produced from the translation prbcess. If you don't code 
the I parameter* a file named LISTING ^111 be used. 



(optional) this parameter specifies the maximum line 
length of PASCAL source to be translated.! The default for 
this parameter Is 120 characters. 



Example of PASTOCYB Usage 

ses.pastocyb i«psoyrce o»csource 

This example shows PASTOCYB translating the !>ASCAL source file 
psource into a CYBIL source file namsi csourbe* The listing 
produced defaults to the file named LISTING. 
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1 6 • G Sil.CIOiMyyi£iIiQMi 



SES provides a communication system sash tliat users can send 
flljs between sites^ and can also MAIL -Rsssages to each other. To 
receive malt* you need a MAILBOX in your catalog. A HAIISOX is 
created by using the SES NEWHAIL procedure. ^hen you create a 
PROFILE using the BulLO PROFILE (BLDPRQF) arocedure tnentloned in the 
introduct ion* a MAILBOX is also created. 

SEND send files between sites with nqs developjaent 

fRachi nes. 



MAIL send mail to other users. 

6ETMAIL displays the mall from your nallbox at your terffllnalf 
or al ternat Ivelyf the mail can be placed in a fife for 
subsequent printing or whatever'. 

NEWHAIL creates a new mailbox* You also use NEWMAIL when you 
want to "clear out" the contents of the sial Ibox* 

ANYMAIL tells you how many items of nail are in your mailbox. 

UHONAIL tells you who sent the Items of mall that are In your 
mai ibox. 

SAVNAIL saves the contents of your mailbox. 

CHKMAIL a procedure SEGMENT that you can INCLUDE Into your 
PROFILE* so that if there is any mall in your mailbox* 
you get a message every time you use SES. 

FEEDBACK SES user feedback mechanism. 
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The MAIL procedure puts a line at the start of every laessage that 
sho*»s you the user name land possibly the ret! naie) of the person 
who sent you the laessage* It«s possible to have your name CIn 
characters) included In this by defining a mynafRs PROFILE variable 
as a string* as follows : 

\ mynawe « *Ethel Snerge* 

Now every time you send a mal I box message to somebody via the 
MAIL procedure* the header of the message In the destination mailbox 
reads ? 

FROM USER ES91 < Ethel Snerge I ON NOV 19, 19?7 AT 9:33 AH 



HAIL also provides the facility to equate »eoo1es» real names 
with their user names* so that you caii send nal I to* say* fred* 
Instead of fjc0795 or some other cryptic machine oriented name. You 
can do this by putting statements like this In your* profile s 



IF FROCNAM « •MAIL* 
fred « •FaC0795« 
bill « 'WAHOOOl* 
andy « •AJL6655* 

IFENO 



THEM 



This series of SES directives in your profile defines the names 
given* but only when the procedure being used Is MAIL. Mai!* you can 
send mai I I Ike this s 

ses«naii letters to (fred* bill* andyl 



Note that when you are using equated nanes of this type you must 
use the to keyword on the MAIL procedure instead of the un keyword. 
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SES provides a set of procedures to submit Jobs and manipylate 
permanent files on remote linked malnfraines* Here Is a suffl^ary of 
the remote access procedures i 

SUBHIT iUMIIs a file to be processed as a batch job on the 

specified «?alnfraf«e» 

GETPF S£Is a Eeraanent file (direct or iniirect) from a refuote 

Biainfraiue to a permanent file Cdlr'ectl on the local 
mainf r a!»e« 

SENOPF i£MQs a copy of a Eerwanent £He (direct or indirect) to 

a direct peraianent file on a remote lalnfrafne* 

CHAN6PF CliAM£es parameters of a Eermanent File on a remote 

walnfr arae» 



PURGPF EUiSEs Crepoves) a gersnanent E^e frofn a remote 

mainf r ame* 



PERHPF EEEMits another user access to a Eermanent £1 1 e» 

CATPF displays tAINst information about Eerwanent £iies 

existing on the remote mainfra^ne* 

DISPOSE PRINTS a file from the local nalnfraue on a printer at 

the remote mainframe* 
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Each mainframe has been assigned a site Identifier* These site 
Identifiers (located in Arden Hlllsl are ? 

nOl - CY176 - S/N 101 
H42 - CY760 - S/N 420 
MIO - Cr73 - S/N 101 
nOZ - CY835 - S/N 002 - S3 
H04 - CY835 - S/N 104 - S2 
H05 - CY174 - S/N 805 
M07 - CY875 - S/N 907 

]i2t£ ' As additional systeflis are added to the networks they are 
assigned a site Identifier* 

In addition to the site-Id* each user nust ha»^ a valid user 
narae» password* charge number ^t\6 project nuflber for the target 
machine* These may be coded into your PRGFILE* The PROFILE 
variables are created by concatenating the site-Id with 'fam* for 
family name* 'use^ for user name* *pas« for' password* 'cha* for 
charge* and 'pro* for project. Users may h^ve PROFILE variables for 
each remote mainframe they are validated to run Jobs on. In 
Interactive mode* the remote link procs requests the family name* 
user name* password* charge* and project variables If they mre not 
in your PROFILE. 

Mt& ' iliil; La kMtSLh a2^£» Lh& t^Ll^hlM 3ii§.l anlil la )LQ,iiL EEO£ILE» 

ElAMLE ' The variables needed for a S/N 420 user to run jobs on 
the Arden Hills 101 would be s 



user name* 
password* 
charge number* 
project number* 
fanlly name* 



If the value for a remote site charge oarameter Is set to a null 
string (for example M42CHA « •')* the remote link procedures omit 
the CHARGE statement In the Job controT statement stream that is 
sent to the remote mainframe for executloi.' 

If a remote site family name Is set to a null string (for example 
MOIFAM » *•)* the family parameter IsT^t specified on the USER 
statement. 



PROFILE 






\ NOIUSE 


« »your 


101 


\ MOIPAS 


* "your 


101 


\ HOICHA 


* fyour 


101 


\ MOIPRO 


a 'your 


101 


V MOIFAH 


« •your 


101 
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16.1 SEND - TRANSMIT FILES BETWEEN HOS SITES 

16.1 E£Ma«=-IS4illliI.£lL£a-i£IM£f i.MOi.iiISi: 

SEND Is a facility to tr ansml t f i I es betiieer* MOS sites. 

When you SEND a file to a remote user^ a coay of the file is 
placed in the special catalog C8E at the reiote sits. This copy of 
the file is a DIRECT access file which is defined with a UNIQUE 
name. The receiver is given MRITE periijssion on the file* and a 
message is mailed to the receiver to inform Him of the real naie of 
the file you sent* and the ynlque name assigned to the file In the 
C8E catalog. The receiver should copy the file to his own catalog* 
and lU&Q, EUEiE iifi Ills, £L2i tUfi £S£ satJlaa. Note that If the 
receiver doesn't have a fnailbox* he won't be In^oriied that the file 
is there. Parameters to SEND are i 



file or f or I 5 

name of the file to be sent to the remote user. 



yn or to s 

User Name of the user TO whom the file Is to be sent* 



at or In s 

Identifier of the site C7 characters or lessl AT or IN 
which the receiver resides* 
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16.1 SENO - TRANSMIT FILES BETWEEN NOS SITES 



Example of SEND Usa^e 



ses.send binflie to hffli006l2 at svl452 

REVERT, ENO SENO BINFItE -> HH00612 AT SVL 



ses.send regards to rdp at arhlOl 

REVERT. ENO SENO REGARDS -> RD? AT ARK 

The two examples show SEND used with all Its parameters. One 
sender Is assumed to be in Arden HI I Is { 4RH101) sending to someone 
in Sunnyvale CSV1452)* and the other exanpfe shows the reverse 
situation. 



Example of NAIL messages received from SEND 

When a remote user sends you files* you receive mall messages 
something like the following ? 

ses.getmai i 

* NAILBOX CONTENTS 

* 

FROM USER C8E ( CYBER 18 RECEIVER ) ON JA^I I4f 1980 AT 12i33 PN 
FILE^ASgRT«ZQ06BS2/UN*C8E FRQH REF CROONEr FOTHERItGAYI IS AVAILABLE 

FROH USER C8E C CYBER 18 RECEIVER 1 ON 4AN 15f 1980 AT 121^5 PM 
FILE^G0F«ZQZWBX6/UN«C8E FROM ERP (EARNEST !>OSTLETHi<AITE) IS AVAILABLE 
REVflERT. ENO GETNAIL 



Now you ATTACH the files from the C8E catalog* copy them to your 
own catalog, and finally EULflfi IhSl XLfll VlS. CSE CaiJifla <and £isjS5 
remember the last step). 
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16.0 SES COMMUNICATIONS 

16.2 MAIL - SEND MAIL TO OTHER USERS 



16.2 aiiL.r«i£M0-!i4iL-.I12.QIM£a.yS£aS 

MAIL is the procedure to send mall to Dther users' mailfooxCsl. 
Raraiaeters to MAIL are? 



I or f 5 

(optional) name of Inpyt File cofitilnlnq the fnail to be 
transmitted to the fflallboxeCs). If yau don't code the i 
parameterf MAIL takes the message fron file INPUT* so that 
if you're at the terminal* it prbupts for* the message. 



un or to : 

list of User Names to whom the ^waM Is to be sent TO. 



at or In : 

(optional) identifier of the site (lachlne identifier) AT 
which the addressees reside. All addressees In the list 
(if more than one) must be at the same site. If you don't 
code the at parameter* mail is ser^t to users on the machine 
you're running on. 



It may happen that one or more people to whon you're sending mail 
don't have a MAILBOX. In this case* If the source of mall Is a 
terminal file (such as INPUT)* MAIL saves the message you so 
laboriously typed in on a unique named file* and Issues a message to 
that effect. If the mail message was on a oer'maneit file* of course 
It is left local anyway. 
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16.0 SES COHHUNICATIONS 

16.2 NAIL - SEND HAIL TO OTHER USERS 



Example of HAIL Usa^e 



ses«maii un»J303 
? Alex s 

? I«ve wade the modifications ta SES(>ROC and 

? replaced it on SESLNAH. 

? 

REVERT. END MAIL INPUT -> J303 



ses«jnatl missifs to (shernany bobf Jivl at nOl 
REVERT* END NAIL MISSIES -> SHERiA^I. , JIH 
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16.0 SES CONMUHICATIOHS 

16.3 GETHAIL - DISPLAY NAIL FROH HAILBQX 

16.3 i2£IMili-««fiii£UI^MIU£EQti-a^liIQ]l 

GETHAIL displays the contents of your naHteox or^ a file* output 
Cthe terniinal If you're an interactive user) by default. Parameters 
to SETMAIL are : 

o or output 3 

Coptionatl name of file to r'acelve the Output from 
GETHAIL. If you don't code the o parameter^ GETMAIL 
displays the wail on file OUTPUT. 



seq 



if you code this (optlonall ^t» GETHAIL writes the 
contents of your mailbox with each line SEQuenced (the 
sequence number will be on the left end of the lines). 
This feature Is useful » for exa^iole* for extracting 
Information from your mailbox vin the SELECT procedure 
(desribed in another section of this document). 



at or from i 

(optional) identifier of the site (machine identifier) 
froii which mall is to be read. If you don't code this 
parameter* GETHAIL reads mail frbn the mailbox on the 
mainframe you're running on. 



user or un or u s 

(optional) user name whose mailbox is to be read. This 
parameter allows you to read mall In mailboxes under other 
user names If you are authorized to read them. If you 
don't code the user parameter* your user* name is assumed. 



Exanple of GETHAIL isage 



ses«getiiiai I 

♦ HAILBOX CONTENTS 

*. 

FROM USER HN03 IValery Vltriolix) ON MO\f 4> 77 AT 4S33 PM 
Sam : 

New version of program now available on the 

project program library, ••••.t.^al 
REVERT. END GETHAIL 
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16«4 HEWMAIl - CREATE A NEW HAItBOX / CIEAR EXISTING MAILBOX 

NEWMAIt creates a new mailboK if one dsiesn't already exist In 

your catalog. If a aiallbox already exists* NEyMAIl deletes any 

I tews previously examined via GETMAIL. There ^rn no parameters to 
NSyMAIlf you simply code s 

ses*neiimai I 



Also see the Introduction to the Handbook for the description of 
the SuilO PRQFile {8LDPR0E) procedure* which in addition to creating 
a profile for you* creates your mailbox as part of setting up your 
initial SES environment. 
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16,0 SES COHHUNICATIONS 

16.5 ANYMAIL - COUNT NUMBER OF ITEMS IN »!AILBOX 



16.5 Mia^Ii-r-£flyMI-iyM££.S£«iIIMS«iM.MIilSi 

ANYHAIL informs you of how many Itetus ttiare are I n your mailbox. 
Parameters to ANYMAIL are i 



output or o 3 

Coptiona!) nanie of the file to vihlch A^fi^AIl writes lt»s 

output. If you don«t code the output par affleter* ANYMAIL 

writes it«s output on file OUTPUT. 



at or on : 

(optionaH Identifier of the site f'tiachlne Identifier) at 
which rsai I is to be counted* If you don't cods the at 
parameterf ANYHAIL counts I tens 1?^ yaur mailbox on the 
mainframe you're running on. 



user or un or un t 

(optional) user name whose utilbox Items are to be 
counted. This parameter allows you to check for mall in 
other mailboxes you are authorized to read. If you don«t 
code the user parameter^ your user name is assumed. 



Examples of ANYHAIL Jsage 



ses.anymai i 

4 LETTERfS) IN HAILBOX 
REVERT. END ANYHAIL 
ses.getmai I storage 
REVERT. END GETHAIL 
ses.neMmai I 

REVERT, END NEWHAIL 
ses.anymai i 

NO HAIL TODAY 
REVERT. END ANYHAIL 



The example shows ANYHAIL stating that there are four letters In 
your mailbox. After doing a GETHAIL to place the inai Ibox contents 
on file storage^ and a NEWHAIL to cl ear out your* mal 1 box> the second 
call to ANYHAIL Informs you that there Is to mall in the mailbox. 
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16.0 SES CQMHUNICATIONS 

16.6 HHOHAIL - DISPLAY LIST OF USERS WHO 4A\/S SEHT MAIL 

WHOHAIi displays the list of users WHO have sent HAIL to yowr 
aiailbox since the last time you did a ^Eil?1AIL. The user nawe of 
each user is displayed along with the date and time that the message 
Has sent* There are no parameters to WHO^AIt. 



Example of UHONAIt Usage 



sescwhomai I 

FROM USER AEN CAIfred £• NeuiuannI ON MOV 2f 79 AT 5il0 PM 

FROM USER FOR OM DEC ll» 79 AT 4«32 A1 

FROM USER JEK ON JAN Zp 80 AT 3aO m 

FROM USER JXH i4Bck Horner) ON FEB 5, 30 AT 8«15 AM 

REVERT. END WHOMAIL 



This example shows the results when there are 4 messages In your 

mailbox at the time WHOMAIL Is used» If there are no messages* the 

only output from WHOMAIL is the endii*? message (REVERT. END 
WHOMAIL). 



16-13 
CDC - SOFTWARE EHSINEERING SERVICES 

18 Oecefflber 84 
SES User«s Handbook REVs 4A 

16.0 SES COMMUNICATIONS 
16.7 SAVMAIL - SAVE MAILBOX 



16.7 SiM^Ii-r.^AII-iiliSQll 

SAVMAIL saves your wai Ibox as a text record on a mul t Ir ecord* 

direct access* permanent file called OlDIAIi.^ If there's no file 

called OLOMAIL In your catalog* SAVMAIL creates one. Parameters to 
SAVMAIL areJ 



title or t 5 

(optional) seven C7> character nane of the text record on 
OLOMAIL to contain the current contents of your {mailbox. 
If you don«t code the title paraneter* SAVMAIL creates a 
name beginning with the letter i and followed by the 
current date In the foria mwddyy. 



Examples of SAVMAIL Usage 

ses«sayiiiai I title»psr42l 

REVERT. END SAVMAIL MAILBOX -> OLOMAIL 

This example shows the case where It was desired that the ipessage 
In the naailbox be saved under an identifiable nawe like a PSR 
number. 



ses.savmal I 

REVERT. END SAVMAIL MAILBOX -> OLOMAIL 

If this example were run on April 22* 1979* your maltbox would be 
saved as record M042279 on OLOMAIL. 



Ufiifi 5 see the Chapter on LIBRARY MAMASEMENTf especially the 
GETMEMCS) procedure* for some words on ^low to handle multl record 
f I les. 
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16.0 SES COHHUNICATIONS 

16.8 CHKHAIL - CHECK YOUR MAILBOX 



16. 8 £ilJi!i4iL«=>£aKll^iayE-iiiUQi 

CHKHAIL is not actually an SES procedure that you can use via a 

sesvChfcmail staten;ent» rather it is an INCIJDE file. Tlie way to use 

It Is to INCLUDE it Into your PROFILE* with an SES directive like 
this in your PROFILE? 

\ INCLUDE 'CHKHAIL'* L«UNIQUE(NAME > * iPFN^SESLNAH, UN«SESUNAf1 



This SES directive line arranges that ev«ry tine you use any SES 
procedure (with the exception of the MAIL prbcedures1» the CHKHAIL 
segment checks your MAILBOX for messagest a^d If there are any* It 
issues a message to tell you to look at your inal f . 
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16.0 SES COMMUNICATIOMS 

16.9 FEEDBACK - SES USER FEEDBACK I^ECHANIS^ 

FEEDBACK ailo)4S you to recorcl a comment or suggestion on the 
usability of SES procedures* or anything you want* The cownients 
mill be collected and reviewed for lno lementat I on by the SES 
project. (The SES project will collect the comments directly on S/N 
101 in Arden Hills. The SES tools InstaMar at other sites have 
been requested to do the same and forward them to the SES project. 
You should confirm that this will be done prior to using FEEDBACK.) 

The comment iuay be entered interactively iihen FEEDBACK is 
executed* or given as a previously created file.? THb time* date and 
your user name are recorded with each coiRiient. Parameters are t 

i or f or file : 

(optlonaM name of input file containing the cowflient to be 
transmitted. If you don't code this parameter f FEEDBACK 
takes the message from file INPUft so that if you're at the 
terminal* it prompts for the message. 



Examples of FEEDBACK Jsage 

ses.feedback flle«cofliment 
REVERT* END FEEDBACK 

This example shows use of FEEDBACK with the previously created 
file conment* 



ses.feedback 

? The 6IBRISH procedure HELP documentation doesn't include 

? BATCH parans* 

? CCR) 

REVERT* END FEEDBACK 

This example shows use of FEEDBACK with the comment being entered 
interactively* 
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16.10 SUSniT - SUBMIT A JOB TO BE PROCESSED AT A !?EHOTE SITE 

SUBMIT provides a wethod for running a Jab on a remote mainframe. 
A user provided job file is processed as a batch job on the 
specified mainframe. A user job for 170 mode execution is 
responsible for getting its output sent to any site other than the 
one the job runs on. This can be done by coding an SES. DISPOSE or 
an SES.SENOPF as part of the job. If neither' of these are coded* 
the output is printed at the remote site where the Job is run. 



on 
s 



A user job for 180 mode execution (applicable to the S2 site 
nly) automatically has its output returned and printed at the local 
ite where the user originated the job. 

f or f n s 

name of file containing the job to be processed* 

at or on s 

site- Id of the mainframe that the job Is to run on. 

node : 

(optional) value (170 or ISO) to Indicate execution mode for 
the job at the remote site* default Is iiode»170; the mode 
parameter is applicable 2Q.ll to Jobs to be run on the S2 
remote site. 

You can set a default for the wode paraieter by defining the 
submode variable in your profile. For instance* \SJSMODE»180 in the 
PROFILE submits all Jobs in 180 mode unless mode«170 is coded when 
the SUBMIT proc Is run. 
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16,11 €£TPF - SET A PERMANENT FILE FRO« A REMOTE SITE 

16.11 S£I££.r-S£I«i«£MMMIiI-£iLi^£EQia-i-:EilQI£^llIl 

GETP? ACQUIRERS a file ffom a rewote malnfraite and wakes a copy 
of it In your catalog on the local malnfra'ae. The copy created on 
the local roalnframe is a direct access fife. If the file Is not 
ynder your user nywber on the remote mnlnfrnmBp you must have 
permission to access the file. 

The procedure Is arranged so that it does not abort. If there 
are any errors detected* the NQS Job Contrbf Register called EF6 Is 
set to a non-zero value. This feature Is used when this procedure 
Is being used as a building block* to deterlnins vihat steps should be 
taken subsequent to running the procedure.' 

Paraiweters to GETPF are J 



rfn i 

name of file to be acquired on the reiate naliframe. 



at or on « 

site~ld of the mainframe from «hlch the file Is to be 
acqui red. 



un : 

(optional) user number of the catalog the file is under on the 
remote mainframe. If this parameter Is not coded* GETPF uses 
the user number value for this site frbn your PROFILE. 



hfn J 

(optional) name to be used for the cooy of the file created In 
your catalog on the local mainframe. If this oarameter Is not 
coded* GETPF uses the value for rfn. If hfn already exists in 
your catalog* GETPF terminates with an error status. If hfn 
doesn't exist* GETPF creates hfn as a direct access file. 



passMfd or PM 3 

(optional) password for the file on the renote mainframe. 
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16.12 SENOPF - SEMO A RERHAKENT FILE TO A ^EHOTE SITE 

SENOPF copies a file froip a local iiafnfrtwe to a remote 
mainfranie* If the file already exists* it is rewritten. 

The procedure is arranged so that it does not abort. If there 
are any errors detected* the NQS 4ob Control Register called EFG Is 
set to a non-zero value. This feature is used vihen this procedure 
is being used as a building blocks to deter'itine what steps should be 
taken subsequent to running the procedure. 

Parameters to SENOPF are : 



hfn 5 

n^me of file on the local mainfrtue that Is to be copied to 
the remote raainfrawe. 



at or on s 

site-id of the remote wainfraee. 



yn : 

(optional} user name that the local file Is cataloged under. 
If this parameter Is not coded* your* user nane is used. 



rfn 1 

(optional) name of file to be created on the remote fnainframe. 
If this parameter is not coded* SEND«»i=« uses the value of hfn. 
If file rfn already exists on the remote «alnframe# SENOPF 
i^rltes the new file over it. SENOPF creates rfn as a direct 
access file. 



passNrd or pm t 

(optional) password associated Mith the file on the remote 
mainframe. 
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16.0 SES COMMUNICATIONS 

16.13 CHANGPF - CHANSE PARAMETERS OF A PER'IANE^T MLB 

16. 13 £aiiiSI£-.r«£aiUiS£-£l£ia£I££S-QE.A«E£Eai^£lI«£Iil 

CHANGPF modifies parasieters of a permar^e?it file on a resiote 
fiainfraffie nlthout re-defining It. Paraffleters for CHANGPF are s 



ofn J 

name of the file on the remote mainfraite to be changed* 



at or on t 

site- id of the remote mainfrafne. 



nffi t 

<optJonall new name of the file on the remote painframe. 



ct t 

(optional) new file category. Must be P {private}* S 
Iseiiil private} or PU (public). If the parameter is not coded> 
the fife category Is not changed. 



(optional) new access wode for the file. Must be WCwrite}> 
M(fnodify}f A<append}# R(read)f ^Mtrsadud)* RA(readap)f 
E(execute)» or N(nu I l-rewoves permission granted by permission 
cominands}. If the parameter is not coded» the access mode 
isn't changed. 



pw s 

(optional) new password (1 to 7 char'acters) for the file. If 
this parameter is not coded* the pass*ior'd Isn't changed. 



status or nostat s 

coding the (optional) status Jisx causes a message to be placed 
in your mailbox when CHANGPF completes. When the nostat Jisx 
is codedf you aren't notified when CHAMSPF completes. The 
default is no message upon completion. ^ 
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16,14 PURGPF - REMOVE CPUR6E) A PERHANEMT FTLE 

16*14 £M£i££.r.MtlQI£-l£yM£l^A^£iEBiM£MI.rill 

PURGPF reaioves a permanent file from a re^iiote mainframe* If the 
file is not in your own catalog^ you must have write permission in 
order to purge it» Parameters for PURGPF are 5 

ofn 5 

name of file to be purged. 



at or on s 

the site-Id of the remote mainframe. 



un 3 

(optional) user name on the remote naHfraie that ofn Is 
cataloged under. 



status or nostat : 

coding the loptionaH status Isfi^ causes a message to be placed 
In your mailbox when PURGPF completes.; When the nostat Ji^x 's 
coded you aren't notified when PURGPF conpfetes. The default 
is no message upon completion. 
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16.15 PERMPF - PERMIT ACCESS TO A PERMANENT FILE 

PERMPF expilcltiy permits another user to access a file In your 
catalog on a remote mainframe* Parameters to ^E^HPf^ are J 

OffI 5 

name of file for \thlch access is be! fig oer'pl t ted. 



at or on s 

site-id of the aiainframe the file Is on. 



un * 

user naiie to be permitted access to the file. 



{optional} permitted fRode of access. If this parameter is 
not coded^ R Cread) permission is used. 



status or nostat : 

coding the (optional) status fsjg^ causes a message to be 
placed in your mailbox when PER^PF conipletes. When the 
nostat Isjai is coded# you aren't notified of PERHPF»s 
completion, the default is no message uoon completion. 



16-22 
CDC - SOFTWARE €NGII^e€RING SERVICES 

18 Oeceiafeer 84 
SES User's Handbook REVs 4A 
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16.16 CATPF - OISPIAYS INFORHATIQN ABOUT A FILE 



16. 16 £AI££.r-Sii£LAXl^IM£flBI!AIII3M«MQUI-i.£ILE 

CATPF displays CATI I st Inf oriaat i on about Per*?!iaient Files on a 
remote ffiainframe. Parameters to CATPF are J 



ofn s 

(optional) file name that catalog Inforsnatlon Is desired for. 



it or on ? 

(required) site-Id of remote naii^rame to get cat list 
information from. 



un : 

(optional) user number of an alternative catalog on the remote 
mai nf rame. 



to : 

(optional) list options for NOS CATLTST confitand* Default Is 
full information <F). 



listing or I : 

(optional) name of file on the local »i»alnframe to receive 
listing* If this parameter is not coded* the listing is 
printed at the local mainframe central site. 



status or nostat : 

coding the (optional) status ^gx causes a message to be placed 
in your mailbox when CATPF completes.^ Whan the nostat Js^^ Is 
coded* you aren't notified of CATPF's completion. Default Is 
no message upon completion. 
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16»17 DISPOSE - PRINT A FILE AT A REMOTE SITE 

16.17 fiII£ai£«=.££iMI.A-£lU«AI.A«a£EaiI-ini' 

DISPOSE prints a file from tfie local waMfrane on a printer at 
the remote mainframe* Parameters to DISPOSE are i 



file or f i 

name of file to be printed. 

at or on t 

site-Id of remote mainframe where file Is orlnted. 

print or p t 

{optional) string containing parameters to control the action 
of the SES PRINT procedure which Is used to print the file at 
the remote site. If yoy don*t cods the print parameter^ 
DISPOSE prints one copy of the file at the remote site* For 
a complete description of the valiies that may be coded for 
the print parameter* see the description of the procedure 
PRINT In the SES USERS HANDBOOK. 
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16.17 DISPOSE - PRINT A FILE AT A REHOTE SITE 

Non~br acketed parameters are required. 

CATPF Cofnif at# Cun3> Clo1» £listi?^g1» Cstatysl 

CHANGPF ofn# att Cnfn3» Ictl* Cjfil> Cp^iI* Cstatusl 

DISPOSE file* at* Cprlnti 

SETPF rfn* at> Cun3> Chfnif Cpw3 

PERHPF ofn* at* un* Cm3* IstattJsT 

PURGPF ofn* at# lunl* Cstatusl 

SENDPF hfn, at# Cun3* trfnl, Cpw3 

SU8HIT f, at, Cmodel 
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17.0 I£n«IIMl£yLMI0M-MIl-i:QliI£Blii3M-yiiLlIlli: 



This section describes a Mst of facilities to perforfa general 
massaging of text files* character set conversion and so on. The 
facilities to be described are J 



EOT run the EOT text editor on a file. 

LOMTOUP convert lower case letters to upoer case* 

UPTOLOW convert upper case letters to lower case* 

COPYACR copy ASCII coded record* 

ASORT sort ASCII files* 

UNIQUE refiBoves adjacent duplicate flies fron a text file* 

HERGE merge up to five files on a colufinar basis* 

OEHERGE split a file Into one to five flies on a columnar 
bas is* 



COMPARE compare two text files ani produce a listing of the 

differences between them* 



COUNT counts charactersf words^ or lines in a text file* 

SELECT extracts ^displays) selected lines and/or ranges of 

lines from a text file* 

HULTEO MULTI record file EOIT facility* 
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PACK "Packs" a wuiti record or luftf f 1 1 a fife into a 

single text records with control characters such that 
it can be "unpacked** again* 

UNPACK »*Unpacks"f that is» reverses tfis action of PACK* 

COHV CONVert the character set o^ a text file. 



JABFORH convert source for the TEXTJAB document formatter to 
source for the TXTFORM document formatter. 



WANG2CY8ER send text fro« a WANG document to a CYBER file. 

CY8ER2ilANG send text froia a CYBER file to a 4ANS document. 

SNQBOi 8-bit SN080L interpreter. 

FIND search a file for specified text oatterns. 

CHANGE change matched text lines In a file. 

XLIT transliterate characters in a file. 
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17«0 TEXT HANIPULATION AND CONVERSION UTItlTIES 
17,1 EOT - RUN THE EOT TEXT EDITOR 



IT • 1 £ai«i:-EyM-.ia£.£fiI-IIlI-.£2iIQE 

EOT runs the EOT text editor for you» EDT Is a^ enhanced version 
of the standard NOS text editor* A descrl^tior^ of EOT can be found 
in an appendix to this document. This EDT orocedure is »ainly 
intended to work in conjunction i«ith procedures such as GETHOOCS)* 
GETMEHCS)* PACK* UNPACK and so on» so that you cartf for instance* 
string a bunch of procedures together* like : 

ses«getiiod ni«nurdle| edtl repiod 

to get a module off a base* edit it aid repfface it ail In one 
procedure line* Parameters to EOT are J 

i or f 8 

{optional) name of Input File containing text to be 
EDITed« If you don't code the i parameter* EOT uses the 
value of profile variable group as the name of the input 
file* and if there's no such variable defined* EOT uses a 
default file name of group* 

ec or input : 

(optional) nawe of file containing Edit Cibmmands to EOT* 
If you don't code the ec parameter^ EDT uses file Input* 

60 or output i 

(optional) name of file to receive Edit Output* If you 
don't code the eo parameter* ED^ uses fil% output* 

t or tabs s 

(optional) TABS parameter for EOT. If you don't code the 
t parameter* there are no tabs set* You may set up a 
default tabs name in your profile by defining the tabs 
var i abl e« 



save or rep 3 

if you code this (optional) kgY* EOT REP I aces the file 

specified by the I parameter in vojr catalog when you've 

finished editing* If you don't code the rep lifii* the file 
Is left local* 
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17.0 TEXT MANIPULATION AND CONVERSION UTILITIES 
17,2 LOWTOUP - CONVERT LQ^ER CASE TO UPPER CASE 



LOWTOUP converts all LOHer case letters In t text file to UPper 
case letters* Parameters for LQWTOUP are : 



I or f ! 



name of Input File containing text to foe processed by 
LOWTOUP. 



(optional) name of file to receive the Output from 
LOWTOUP* If you don't code the o paraweterf the output 
appears on the file specified by the I Ptraiseter* 



Exaaple of LOUTOUP Js^ge 



ses.lowtoup i«lo)fcase» o^upcase 

REVERT, END LO\ITOUP LOMCASE -> UPCASE 



This example shows LOWTQUP converting all' lojier case letters in a 
file called lONcase Into upper case letterst and produce the output 
on a file called upcase« 
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17.0 TEXT MANIPULATION AND CONVERSION UTILITIES 
17,3 UPTOLOy - CONVERT UPPER CASE TO LOWER CASE 



17.3 y£IQLQi^=-£QliM£EI^ilE£££«iIiS£«ia-LQE£E.IIii£ 

UPTQLOW converts all UPper case letters i r^ a text fMe to LOWer 
case. Parameters for UPTQLOy are s 



i or f s 



o 3 



narpe of Input FMe contalnl^^g text to be processed by 
UPTOLOy. 



(optionatl name of file to receive ttie Output from 
UPTOLOW. If you don*t code the o oarafReter* the output 
appears on the file specified by the I parameter. 



Example of UPTQLOU Usage 

ses«uptolOM i«uppef9 o«ioiier 

REVERT. END UPTOLQW UPPER -> LOWER 

This example shows UPTOLOW converting all upper case letters in a 
file called upper to loiier case letters* a^id producing the output on 
a file cal i ed I otier. 
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17.0 TEXT MANIPULATION AND CONVERSION UTfLXTIES 
17,4 COPYACR - COPY ASCII COOED RECORDCSI 

COPYACR stands for COPY ASCII Coded RecardCs)* and as Its name 
implies^ It Is the ASCII equivalent to the standard NQS CQPYCR 
ytiiity* This COPYACR procedure does a bit ^ore tfian the standard 
NQS COPYCR 5 it acquires the Input file for you* and rewrites the 
output file back over the input file If yon specify It that way» 
COPYACR can also perform some character set conversl ons for you <see 
beloM)« Parameters to COPYACR are t 



i or f J 

narae of Input File containing teict to be processed by 
COPYACR. 



(optional) naee of file to recelye the Output from 
COPYACR. If you don't code the o para^neterj the output 
appears on the file specified by the I parameter. 

cols or c : 

Coptional) specification of the COLunnS between which the 
file Is to be copied. The c parafweter' must be coded as a 
rangcf or in the forra loit«.hlgh» where flow Is the left 
column at which to start copying* and high Is the right 
column beyond which the file is not to be copied. If you 
don't code the c parameter* COPYICR uses the range 1««80 
for the copy. 

incset or Ic : 

(optional) designator for the IMuut file's Character SET. 
The table below describes the aMo^ied designators. 



outcset or oc s 

(optional) designator for the OOTout fife's Character SET. 

The table below describes the atlo^ed designators. 

Both the Incset and outcset parameters default to fisMi (see 

below) but this can be over-ridden by defining In your profile 

defaults via variables with names the sane as the parameters. The 

following table defines the allowed designator's for* the incset and 
outcset parameters i 
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17.0 TEXT MANIPULATION AND CONVERSION UTIIITIES 
17.4 COPYACR - COPY ASCII CODED RECORDCS) 



• t 
t « 

« t 

+-., , — . -..4. — ••• — . ^ . — «. -«- — ^ ^ ^ — «— 

n » 

J CS612 ! NOS 6/12 ASCII character' set 

• t 
« t 

• I 

t * 

I cs64 t 64 character ASCII sjbset (display code) 

• I character set 

4. — : — -.«.« « -.^«^-.^- -.-, . ^ — -«^ — — . — - — ^^ -« . — -- .- 

• * 

J CS812 1 «8 out of 12»' ASCII character set 

t « 

4 t 



Example of CQPYACR J^age 



ses«copyacr grab hold 11««17 
REVERT. END CQPYACR GRAB -> HOLD 

This example shows CQPYACR copying fife grab between columns 11 
thru 17 inclusive* and placing the result 9f the copy on file hold* 
You might wonder what's the use of doing t^iat? ^ell the NOS CATALOG 
utility outputs the record names starting In column 11* so you could 
use this example of COPYACR to Isolate all the record names* 
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17.0 TEXT MANIPULATION AND CONVERSION UTILITIES 
17.5 ASORT - SORT ASCII FILES 



ASORT is a utility to sort ASCII f i les accordl n§ to sets of sort 
directives. Paraiaeters to ASORT are J 



i or f : 



keys 



name of Input File to be processed by ASORT* 



(optional) nawe of file to receive the Output from ASORT. 
If you don't code the o paraieter» ASORT places ttie output 
file on the file specified by the I parameter. 



list of sort KEYS to direct the sort process. Each 
element in the list of keys consists of three Itews. The 
first itew is the start column of the fields the second 
item is the (optional) length of the field (default 1 
character)* and the third Iten Is the (optional) sort 
order* A for Ascending* and for Descending. The default 
is Ascending order. There Is sin examplie of ASORT at the 
en6 of this description. 



retain i 

this (optional) }i&x is the S0RT5 RETAIW option. If you 
don't code the retain ii£i* S0RT5 ojtouts Identically keyed 
records In arbitrary order. If you do code the retain 
iX£l* such records are output in their original order. 

datt ' the collating sequence for ASiJRT is the ASCII collating 
sequence. Upper and lower case letters are considered identical for 
the sort process* so that alphabetic Itens aren't separated by an 
entire case of the alphabet. 
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17.0 TEXT MANIPULATIOH AND CONVERSION UTILITIES 
17.5 ASQRT - SORT ASCII FILES 

Example of ASORT Usage 

se$«asort l«shufftd# o»orderly» keys«CCl>7l>fl9»7fCl)f (21*411 
REVERT. END ASORT SHUFFLD -> ORDERLY 

This example shows ASORT sorting the file shuffl13 onto the file 
orderly* The keys used are colutan 1 for a length of sey^n 
characters* in ascending order Csince that'is the de«*tult)# column 10 
for a length of seven characters in desce^^dlng orfi^tf and column 21 
for a length of four characters* In ascending order (again 
defaulted) « 



ses«asort l^hlggidy* o«llneduPf iceys*tfl4» 3» d)) 
REVERT. END ASORT MIGGtOY -> LINEDUP 

This example of ASORT highlights one of the minor inconveniences of 
parameters that are lists of lists* namely* that ev^n ¥ih%r\ you've 
only got one key to sort on* you still need double oarentheses. The 
foilovfing discussion explains the keys paraneter'. 

The keys parameter is a list of sort keys? each filfiifiui of that 
list is itself a list of up to three eleiiants. So at the top level 
you get this situation : 

keys«(key.l* key«2* key.3*..^!.! key.nl 

each key^i Is itself a list of one to three elements i 

(start.coluan* key. length* sortr.dir ecti on} 

start.,coluiifi is the column position of the start of the sort key. 

key.length Is the number of characters in the key> inclusive of 
start^coluflin - the default key.length Is !•' 

sort.dl rection Is a single letter indicator' J A for Ascending order 
(the default)* for descending order. 

So let's look at some real live examples of sort keys : 

keys»((4* 2* dl* (11* 7* dl) 

Is a list for ^jia sort keys* the first starts In column 4* Is 2 
characters long* and is sorting In descending order? the second 
starts in column 11* Is 7 characters long* and Is also sorting In 
descending order. Here's the saifi list* but this time the sort 
order is ascending* so you can leave out the direction indicators ? 
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17.0 TEXT HANIPULATIQN AND CONVERSION UTILITIES 
17.5 ASORT - SORT ASCII FILES 



keys-IHf 2)f <lXf 711 

Now let's look at soj^e more default cases; suooose tfie column 4 key 
Is oniy aai character long - now you can ^rlte the keys like this s 

keys«U4f 1)# Cll# 711 

but the key^length of one is the default* so It can be written J 

keys«l(4l# lilt 71) 

harking way back to chapter 1 and the section called '•lists of 
values for par ameters*'# recall that a single slewent list doesn't 
need the parentheses * 

keys(4» C llf 711 

Now let's shorten it still further by reducing the seven character 
field to one : 

keys«C4» 11) 

Getting down to the mlnifflufn case of a single key of length one in 
ascending orders you get s 

keys«4» keys«CC4# 1)) and keys«CI4# 1# all are all identicals 
whereas : 

keys«C7> 12) means keys«(l7# 1)> <12# 1)) 
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17,0 TEXT HANIPULATION AND CONVERSION UTILITIES 

17.6 UNIQUE - REMOVE ADJACENT DUPLICATE LINES 1=R01 A FILE 

UNIQUE removes adjacent duplicate lines from q text file* Such a 
situation usually arises when a file Nts been sortedt (as for 
exafflpie with the ASORT procedure previously dsscribed) and duplicate 
lines In the file are all together* UNIQJE provides the capability 
of reducing the file to one Instance of each unique line* For 
exafljple* UNIQUE acts as follows t 

iQfittt £iis Qiitsitt £iis 

Just the place for a Snark Just the ^lace for' a SnarK 

the Bellman cried the Bellwan cried 

the Bellman cried as he landed his crew with care 

as he landed his crew with care supporting each one 

supporting each one on the top af the tide 

on the top of the tide with a finger ent-^ined In his hair 

on the top of the tide 

on the top of the tide 

with a finger entwined in his hair 

With that exafnple to show how it works* the parameters to UNIQUE 
are s 

I or f J 

name of the input £ile containing the text which is to have 
the adjacent duplicate lines reaioved* 



is the (optional) name of the O^itput file from the UNIQUE 
process* If you don't code the o parameter* the results 
appear on the file specified by the I parameter* 
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17.0 TEXT HANIPULATIQN AND CONVERSION UTTLiriES 

17.6 UNIQUE - REHQVE ADJACENT DUPLICATE LIMES P^tQH A FILE 



Examples of UNIQUE Us^cie* 



ses«unique i«sorte<l# o«renioye(3 

REVERT, END UNIQUE SORTED -> REMOVED 



ses.unique dupl ies 

REVERT, END UNIQUE DUPIICS 
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17«0 TEXT MANIPULATION AND CONVERSION UTILITIES 
17*7 HERGE - MERGE UP TO FIVE FILES INTO 3ME FILE 



17.7 i£E£i^=^i££Si.y£.I£l.£iM£-£iL£I-iMIQ«QiS.lIli 

MERGE coiabines up to five files on a cotiinnar basis. Parameters 
to MERGE are i 



name of file to receive the Output of MERGE 



m or merge s 

a list of up to five column widths specifying how the 
input files are to be MERGEd into the output file {see the 
example beto^}* 



I or f 



(optional) list of up to five Inout Flies to be MERGEd 
onto the file specified by the o oaraieter. If you don't 
code values for the i parameter* MERGE uses filenames 
tapel thru tapeS for Its Input fifes* 



Example of MERGE Usage 

ses«mer9e o«diagraRi» n>C21^21#2i)9 i«(coli]iinl» cotuiiin2> coluiRnSI 
RSVERT. ENO MERGE COtUHNl#COLUMN2»t!3LUMM3 -> DIAGRAM 

In this example* MERGE is constructing a fife called diagram* by 
merging together the three files coiumnl* coliimn2# and columfiS* The 
contents of file columnl occupy the first ?1 columns in the diagram 
file* the contents of file column2 occupy colu'nns 22 thru 42 In the 
diagram file* and the contents of file eo1U!iin3 occupy columns 43 
thru 63 in the diagram file* 
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17.0 TEXT MAMIPULATIQN AND CONVERSION UTILITIES 
17.8 DEMERGE - SPIIT fllE APART BY COLUMNS 

DEMERGE splits a file Into one to five files on a coluflinar basis* 
Paraweters to DEMERGE are t 



i or f s 

name of Input File which Is to be DEMERGSd* 



d or demerge : 

a list of up to five coIu^t widths specifying how the 
Input file is to be DEMERGEd inta the output files (see 
the example below)* 



o t 

(optional) list of up to five fifes to receive the Output 
of DEMERGE* If you don't code values for the o parameter* 
DEMERGE uses tapel thru tapeS* 



Example of DEHERGE tllsa^e 

sesttdemerge l«compile» d»l81»23}# o«<s9iir'eef numbers) 
REVERT* END DEMERGE COMPILE -> SOURCE* TIMBERS 

This example shows DEMERGE splitting up a file called compile 
into two components* In this example {ta!<er» froiB real life)* the 
first 81 columns of compile are the source statements from a master 
audit of a deck In an UPDATE PL* and the last 23 columns are the 
statement numbers* The two separate sets of data appear in the 
example on files source and numbers* 
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17.0 TEXT MANIPULATION AND CONVERSION UTILITISS 
17,9 COMPARE - COMPARE TEXT FILES 

The COMPARE procedure compares two text fifes and produces a 
••listing" of the differences between them in terms of Inserted* 
deleted* and replaced tines* Parameters to COMPARE are s 



new 



old 3 



this (optional) paraineter specifies tlie na?B€ of the file 
containing the ••new* version of the text. If you don't 
code this parameter* COMPARE uses a file called new* 



this (optional) parameter specifies the riaiwe of the file 
containing the ••old*' version of the text. If you don't 
code this parameter* COMPARE uses a ^lle called old. 



this (optional I parameter specifies the nawe of the file to 
receive the output froia COMPARE. If you don't code this 
parameter* COMPARE writes the restjlts of the comparison to 
file output. Note that If the two ^iles are equivalent* 
COMPARE doesn't write anything to the o fife. 



newcset 



ol dcset 



(optional) designator for the NE^ flle«s Character SET. 
The table below describes the alloifed designators. 



(optional) designator for the OLD file's Character SET. 
The table below describes the allowed designators. 



outcset : 

(optional) designator for the OUTPut file's Character SET. 
The table below describes the allowed designators. 



Is or ignoris : 

these (optional) Kfiis specify whether or not to iSHQEe 
Reading Spaces on lines being coT^pared* The default action 
is to recognise leading spaces (the Is option). If you 
code the Ignorls ii£i* COMPARE Igiares leading spaces on 
text I I nes» 
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17.0 TEXT MANIPULATION AND CONVERSION UTTLITIES 
17.9 COMPARE - COMPARE TEXT FILES 



The default character set designator for all three cset 
parameters is £S§12. The following table defines the alloned 
designators for the cset parameters t 



Q^^latiAtaL 



Msaaiaa' 



cs612 



! NOS 6/12 ASCII character* set 



cs64 



-I— 



I 64 character ASCII sjbset (display code) 
J character set 



CS812 



J "8 out of 12« ASCII cfiaractsr set 
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17. G TEXT HANIPULATION ANO CONVERSION UTILIftES 
17.10 COUNT - COUNT THINGS IN A FILE 

17. 10 £flyiii.=^£QyMi-iiiiaas«iM«A.£iLi 

COUNT counts one of the following three tilings In a file : 

characters number of ASCII characters in § fHe. 

lines number of lines* 

Mords number of words in a flle» where a "^ord" is defined as a 

contiguous set of characters dellinited by space(slf 
tabCs) or newl IneCs)* 

Parameters to the COUNT procedure are 5 

c or chars or I or lines or w or MOfds ? 

these kSlS define which thing is tt> be counted {£haractersf 
i,i nes or ji^lor ds) • 

I or f or in s 

name of Input £lle I^i which the things are to be counted* 

o or to 5 

is the (optional) name of the ijutput file IQ which the 
results of the counting process ar*e to go*' If you don't 
code the to parameter* the results go to file output* 



Examples of COUNT Usage 



ses*count lines In source 

7396 

REVERT. END COUNT SOURCE 



ses.count words In guide to results 
REVERT. END COUNT GUIDE -> RESULTS 



The first example shows COUNT counting the nuiber of lines In a 
file called source* with the result going to file output by default. 
The second example counts the number 3f ^ards In a file called 
guide* with the answer written to a file caHed results* Note that 
the choice of parameter keywords meais »ie can specify the COUNT 
process in a more "English" form. 
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17.0 TEXT HAMIPULATION ANO CONVERSION UTILiriES 
17,11 SELECT - COPY SELECTED LINE RANGES ^td^ A l=ILE 



17.11 SiLi£I^r.£a£I«if Li£IEfi-U!:!£.iM5£l-.£lllw^:-lILl 



SELECT copies selected lines or ranges of lines from one file to 
another* The default output file used by SELECT is In fact file 
outputs so that the utility provides an easy i#ay to look at selected 
parts of a file without needing to edit the file. Parameters to the 
SELECT procedure are : 



I i ne or I ines ? 

is a list of line numbers or line number 
selected from the input file. 



ranges to be 



r or f or of 5 

is the name of the X^^P^t £1 1 « fr'bm »hich the lines or 
ranges of lines are to selected. 



o or to 



Is the (optional) name of the Qutput file IQ 
selected lines are to be copied. If you don't 
parameter* the selected lines go to file output 
You can code the output file naue to be the 
input file naiae in which case the Input 
overwritten by the selected lines. 



which the 
code the to 
by default, 
same as the 
f i I e gets 



Examples of SELECT Usage 



ses.sel ect 
Beware the 
REVERT. 



I ine 50 of sonf i le 

fruiilous Btndersnatcti ny son. 

END SELECT SOMFILE 



ses.sel ect 

REVERT. 



lines 10..19 of nurdle to twisted 
EHO SELECT NUROLE -> T«ISTEO 



ses.sel ect 

REVERT. 



lines C5#7#9..17#19#23«.47l of primes 
END SELECT PRIMES -> SIFTED 



to sifted 



The three examples shown above should give a good idea of the way 
that SELECT is used* showing a single line* a range of lines* and 
finally a list of lines and line ranges. Invalid line numbers and 
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17.0 TEXT MANIPULATION AND CONVERSION UTILITIES 
17.11 SELECT - COPY SELECTED LINE RANGES f^m A FILE 



ranges are diagnosed. Line ranges In which the high end of the 
range is larger than the number of lines In the Input file cause the 
selection to go to the end of the input fil%. 
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17.0 TEXT HANIPULATION AND CONVERSION UTILITIf=S 
17.12 MULTED - EOIT NULTI RECORD FILE 



MULTEO provides the ability to edit a nalti record file. This Is 
especially useful for insttr^cef where majdr* tn?l ^ttsbal changes must 
be made to many decks of a source text progirai» library. It Is easy 
to generate a SOURCE file* HULTED that flf%» then replace the decks 
on the PI. HULTED uses the PACK and UNPAC< procedures to change the 
wulti record file to a single record file r^ady far editing* and to 
reverse the process when editing is complete. ^ilLTED invokes the 
EOT text editor* an enhanced version of the standard NOS text 
editor. A description of EOT can be found In an appendix to this 
document. Parameters to MULTED ares 



I or f 



name of File containing NULTEO liput 



(optional) name of file to receive the Output from liULTED. 
If you don't code the o parameterV" the output appears on 
the file specified by the I parameter. 

ec or input t 

Coptional) name of file containing Edit Commands to be 
used by EOT* If you don't code the ec parameter* MULTED 
assumes that the edit commands are coTiing from file INPUT. 

eo or output : 

(optional) name of file to receive Edit Output. If you 
don't code the eo parameter* ^ULTID assumes that the 
output Is going to file OUTPUT. 



t or tabs i 

(optional) TABS parameter for EOT.i If y9u don«t code the 
t parameter* HULTEO doesn't set any tabs. You may set up 
a default tabs name In your profile by defining the tabs 
var i abl e. 



cc 



(optional) Control Character to be used for the 
PACK-UNPACK process. If you don't code the cc parameter* 
HULTED uses a control character of slash (/). 
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17,0 TEXT HANIPUtATION AND CONVERSION UTIIITIES 
17,12 MULTED - EDIT HULTI RECORD FILE 



save or rep 5 

if you code this (optionan fifii^* MflLTEO REPIaces the file 
when editing is cosiplete. I?* you dlo?i*t code either of 
these keys» MUITED leaves the fff% focaf.* This parameter 
is only applicable on Indirect access fflis* 



Example of using HULTEO* 

ses*iiiulted rlgort iiiortice» cc««?* 

This example PACKs file rigor* Inyokms EOT to edit the PACKed 
file, and finally UNPACKS the fife onto ^11 e wor'tlce. The PACK 
process turns all physical EOR»s and EO^^^'s Into the character 
strings ?EOR and ?EQF respectively* and th» J^^ACK process reverses 
the operation* 
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17.0 TEXT NAHIPULATION AND CONVERSION UTILITIES 
17.13 PACK - PACK MUtTI RECORD FILE 

17.13 £i(IE.=«aik£ll-llULII-E£QQEa-£iL£ 

PACK packs a nnultl record file into a single record In such a way 
that the record structure is maintained^ a'ld itiay be reconstituted by 
a subsequent UNPACK. It is a useful facility when you want to edit 
a mult I record text file for instance. Par*ai»eters to PACK are? 



I or f J 



cc 3 



(optional) name of Input File t3 be PAC<ed. If you don't 
code the I parameter^* PACK uses the nnme associated with 
profile variable group. If there Isfi't such a profile 
variable defined* PACK uses a flfenaiie of group. 



(optional) nanse of file to receive the Output from PACK. 
If you omit this parameterf the autput appears on the file 
specified by the i parameter. 



(optional I Control Character to be used for the PACK 
process. If you don't code the cc oaraieter* PACK uses a 
control character of slash C/). 



Incset or ic i 

designator for the INput file's Character* SET. See the 
table below for a description of the allowed designators. 

outcset or oc * 

designator for the OUTput file's Character' SET. See the 
table below for a description of the allowed designators. 

The following table defines the desi tinators allowed for the 
Incset and outcset parameters: 

CS612 6/12 character set (defajit) 

CS64 display code character set 

CS812 8 out of 12 ascii character set 
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17,0 TEXT HANIPULATIOH AND CONVERSION UTILITIF? 
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Example of PACK Usa^e 



ses.pack i«wultree> o»pacl(edf cc««M 
REVERT. END PACK MUtTREC -> PACKED 



This exatiipie shows PACK being ysed to '•s>ack" a lultl record file 
cailed muitrec and produce tlie output of the process on a file 
called packed. The control character i Is iisedt so that every 
physical EOR In the file is replaced by the character string lEOR in 
the output. 
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17.14 yM£i£K^r-ya£Mll.IOi-f liI«IQ-.MyiII-Eli:il!l.EILl 

UNPACK provides the converse operation t3 thtt provided by PACK* 
or it unpacks a single record text file into a ^nulti record file* 
Parafneters to UNPACK ares 



I or f J 

{optional} nai«e of Input File containing data to be 
processed by UNPACK. If you don^t code the I paraweter* 
UNPACK uses the narae associated ^\th profile variable 
group. If there isn't such a profile variable defined* 
UNPACK uses a file nasie of group.' 



o : 



cc 



(optional) name of file to receive the Output from UNPACK. 
If you don't code the o parameter* the output appears on 
the file specified by the i paraneter'. 



{optional) Control Character to ha used for the UNPACK 
process. If you don't code the cc parameter* UNPACK uses 
a control character of slash i/).i 



Incset or Ic 3 

designator for the INput file's Character' SET. See the 
table below for a description of the allowed designators. 

outcset or oc i 

designator for the OUTput file's Character SET. See the 
table below for a description o** the allowed designators. 

The following table defines the designators allowed for the 
incset and outcset parameters: 



CS612 6/12 character set (default) 

CS64 display code character set 

CS812 8 out of 12 asci i character* set 
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Exaiiple of UNPACK Usage 

ses*ynpack i«packed# o»unpackd» C€««l* 
REVERT. END UNPACK PACKED -> UNPAGED 

This example shows UNPACK being used to reverse the "pack" 
process described in the previous section. The file packed Is 
•unpacked' onto the file unpackd. The control character of I is 
used so that every line that has a lEOR start in?i In column one Is 
replaced i^ith a physical end of record in the output file. 
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17.15 i;aiii..r«iLQMJ££SI-£UMMI£E«i£I 

CONV converts text files from one character set to another* If 
the text file contains €OFs# CONV itlfli stop at the first EOF 
encountered. NOTE - Due to Its flexibility* the canverslon process 
is fairly time consuming* Paraineters to C1HV are J 

i or f s 

name of the Input File contalnif^g text to be converted* 



o : 



(optional) naiae of the file to receive the Output from 
CONV. If you don't code the o parameter* the output 
appears on the file specified by the f paraweter. 



Incset or ic : 

designator for the INput f I I e«s Char act er SET. See the 
table below for a description of the aManed designators. 



otitcset or oc : 

designator for the OUTout file's Character SET* See the 
table below for a description of the allowed designators. 



The following table defines the deslainators allowed for the 
incset and outcset parameters: 

N63 NOS 63 6-blt codes 

N64 NOS 64 6-blt codes 

N612 NOS 6/12 ASCII 6-blt and l?-blt codes 

N612U same as N612 except that all letters are upper 

case 

N612L same as N612 except that all fetters are tower 

case 

NBE63 N0S/8E 63 6-bJt codes 

N8E64 NOS/BE 64 6-bit codes 
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NBE63A NQS/8E ASCII 63 character subset 7-blt codes 15 

per word) 

NBE64A N0S/3E ASCII 64 character subset 7-blt codes (5 

per word) 

ASCII4 full ASCII 7-bit codes C^ per wor^dl 

ASCII5 full ASCII 7-bit codes (5 per word) 



A table of these characters sets can be found i fi an appendix to 
this docuiaent. 



17-28 
CDC - SOFTWARE EHGIMEERING SERVICES 

18 Oacswfoer 84 
SES Usar«s Handbook REV J 4A 

17.0 TEXT HANIPUIATION AKO CONVERSION UTIIITIES 

17.16 JA8F0RH - CONVERT TEXT4A8 SOURCE Tfl TXTFOR^I SOURCE 

4ABF0RM converts source for the TEXTJAB document fonnatter to 

source for the TXTFORH document formatter. JABFORM only works on 

TEXTJAB source format directives that are dell?Blted. Parameters to 
JABFQRH are t 



I or f : 



o s 



name of the Input File containing the TEXTJAB docu!i»ent 
source. 



na«ie of the file on which the TXTF3Rfi source is written 
Out. Miiifi that unlike many otNar SES procedures JABFORM 
doesn't overwrite the Input file i«ith the Output file. 



(optional) nawe of the file to receive erVor messages from 
JABFORH. If you don*t code the e parameter > JABFORM uses 
file ERRLIST. 



A complete description of the conversions performed by JABFORM 
can be found in an appendix to this document. 



e i 
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17,17 WANS2CYBER - SEND TEXT FROH MANG Di3:. T3 CfSER EIIE 

WAHG2CyB£R tfansruits a document from a 4ANS to a text file on a 
CYBER. To perform the transfert a VIA'^S te I ecorawunicati ons 

environment is necessary* Parameters for^4^IG2CYBER are s 



o I 



Ufl 1 



(required) name of t*?e text file on CYBER* If tfiis file 
already exists* WANG2CYBER will append the WANG document to 
the end of this file. If this file doesn't exist* 
iilANG2CYBER will create a direct access file in the catalog 
of the current user* 



(optional) user name In whose cttilog the text file 
specified by the o parameter is to be found* If you don't 
code the un parameter* WANG2CY8ER uses the user name of the 
current user* 
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17.18 CY8ER2WANS - SEND TEXT FROH CYBER FILE TO I^ANG DOC. 

CYBER2WANG transmits a text file from a CYBER t9 i document on a 
VIANG. To perform the transfer* a i^ANS te I eco»nmuni cations 

environment is necessary. Parameters for CY3ER2WA^iG are t 

I or f s 

(required) name of the text file ori CYBER. 



un 



(optionall user name in whose catalogi the text file 
specified by the I or f paraiisetar* Is to be found. If you 
don*t code the un parafneter* CYBE^?»IANS uses the user name 
of the current user. 



txtcode or txtforis t 

Coptlonan Hfii indicating to CYSER^WAMG that the text file 
specified by the I or f parameter is txtcode or txtform 
source. If you don't code the txtcode or txtform jsfij£ 
CY8ER2WANG assumes that the text is neither txtcode or 
txtform source and transmits the text asls. 



(WARNING? The TXTCODE or TXTFORM source lust be capable of being 
formatted by using the BACKUP parameter 3i SES. FORMAT.) 

If you transmit txtcode or txtform source* a WANG conversion 
glossary is available to further massage your docunent once WANG has 
it. Please call Betty Hawes on Contrblnet No. 235-3019 lor 
612-482-3019) and arrange to obtain the WAMG For'nat Glossary 00001. 
Once you have obtained the glossary* attach It to your document and 
execute glossary entry P; then execute glossary entry L. 
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17.19 SfiQa0i-.r-.5r iII-.^liaiQUiMI£E£a£I£E 

SH080L Is an 8-bit version of the SN083L4 interpretar. SNQBOL 
aff jclonados will realize that SM030L requires botfi program and data 
on the same input fllei using the SES SNQBtIL procedure you can lif 
you wanti have the program and data on separate fiftes* in which case 
SES gathers them onto the same file befor*e running SNQBQL. The 
SNOBQl interpreter requires its input in 8-12 ASCII and produces its 
output in the same character set. Parametars ^re s 



1 or I s 

name of Input £iie containing the SNOBOt source program* 
and* if you wish* data for the program. You can also 
specify a data file with the d par^aneter. 



d or iMlM t 

is the (optional) name of a fiat a file for the SHQBOi 

program. If you do code this parapetert the data file is 

appended to the input file speclfisi by the I parameter. 



fi 2 



(optional} name of file to receive the QutPut of the SNOBOt 
run. If you don't code the o paranetert the output appears 
on the file specified by the I paraieter. 
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17.20 £iyB.r«£iii2.£MI£Itii-.lM«l-£IL£ 

FIND searches a file line by line* looking for" specific JtftXi 
EJti£CIIS Of tSiiJiljiC 5Xfi££SSifiQS« There Is a discussion on regular 
expressions later. The pattern to be locatetl In the file may be 
specified on the SES control statementf or*» If there are loner case 
characters which can't be represented^ an argument file (default 
input) fliay be supplied* Parameters to FIniD are s 

P or pattern or with or using * 

(optional) pattern specification,! If yau don»t code this 
parameter at all* FIND takes Its argu^tient pattern froia file 
input» and prompts you accor«ll ng ly. The p or pattern 
keywords or no keyword Indicate that the j>attern is right 
there on the SES control stateient. The with or using 
keywords indicate that the patter*ri Is in an argument file 
which is specified as the value of the parameter. 

I or In or f s 

Is the name of the input File I>1 which the regular 
expressions are to be located. 

or onto : 

(optional) na»e of the file QMO «hich the Output of FIND 

Is to appear. If you don't code the o parameterf the 

output appears on file output by default. 
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Examples of FIND Ustge 



ses.find «C0-93$« Ifianyflle onto«outpat 
REVERT, END FIND HYFilE -> OUTPUT 



ses.find usi ng»patf i le in«oldfiie onto*f oufidlt 
REVERT. END FIND OLOFILE -> FOUNDIT 



ses.find 'f.'^f* in*co<ipiie 
REVERT. END FIND COHPILE 



The first example shows FIND locating all tines In myflle that 
have a digit at the end of the line. The result appears on file 
output* The second example shows FIND used «i th a pattern file 
patfiie. The third example Is locating all lines that contain a '#« 
sign followed by a run of any characters followed by another «#• 
sign. Such lines are reasonable candidates for being SYMPL comment 
I ines* 



l£2&t.£all.fii:£is.anii.EfiauiaL.£2L£L£^&iaii^ 



This discussion introduces the notation for regular expressions 
used by FIND and the CHANGE procedure In the next section. The 
notation is terse but versatile* and has bsen applied in a number of 
pattern matching utilities. 

A t£lit SAtlfitD can be a simple t hi not like tfie letter a or a 

more elaborate construct built up from sinple things* like the 

string format. To build arbitrary text patterns you need only know 
a few rules. 

Any iits£jl fitljcafiifit* such as a* Is a text pattern that matches 
that same character In the text being scanned* A sequence of 
literal characters like 7926 or grabhold Is a pattern that 
matches any occurrence of that sequence of characters In a line of 
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the input. 

A pattern Is said to BMtst part of a te?ct line If the text line 
contains an occurrence of the pattern. For* Instance the pattern aa 
matches the line aabc once at position !♦ the line aabcaabc In 
two places* and the line aaaa In three C over I appi ng J places* 
Hatching is done on a line by line basis s no pattern can match 
across a line boundary. Text patterns fflay be saasj'tfilialfiiJ s a text 
pattern folloKed by another text pattern foriis a ^lew pattern that 
matches anything matched by the first* follo**ed iiBwedl ately by 
anything matched by the second. A sequence of literal characters Is 
an exanple of concatenated patterns. 

find h^s other capabilities - the ability to search for patterns 
that match slisaSS ^^ characters* that natch patterns only at 
particular positions on a line* or that latch text of Indefinite 
length* 

To be able to express these more general patterns* we have to 
preempt some characters to represent other* types of text patterns* 
or to delimit them. For example* we use tNa character • as a text 
pattern that matches jfii single character except a newline. The 
pattern x.y matches x*y* xay# x?y and si nl lar strl ngs. 

The • and other reserved characters are often called 
lfillifttllC.afitfitS* We try to choose char acter's whi ch won't appear with 
high frequency in normal text* but still there are occasions when we 
want to look for a literal occurrence of a metacharacter. Thus the 
special meaning of a metacharacter may be turned off by preceding It 
with the S££a&£ character 9. Thus 3. Hatches a literal period* 
and 39 matches a literal at sign. 

The metacharacter C signals that the characters following* up 
to the next 3 form a siiJCJfiifit filjiss* that Is* a text pattern that 
matches any single character from the brac<Bted list. For example* 
CaAl matches a SLt A* Ca-2l matches any lower case letter. 

There is a aeaatfiii l«ilA£a£tfi£. £iaSLS' such that C^a-z] matches any 
character except a lower case letter* and so forth. Note that a 
negated character class never matches a newline. The escape 
convention can also be used inside character classes If the 
character class is to contain " or - or* 3 or 1. 

Two other metacharacters don't match literal characters but 
rather match positions on the Input line.? * Hatches the lifiaiQCiflja 
of a line J '^abc is a pattern that matches abc 2¥ll ^** 't appears 
as the first three characters of an Input line. Similarly* 
$ matches the newline at the end of a line : abc$ 

matches abc only if it Is the last thing on a line before the 
newline. Of course these can work together : '*abc$ matches a line 
that contains QUiX abc* and ^% matches only empty lines (lines 
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containing only a neviline)* 

Any of the text patterns above that latch a single character 
(everything but * and $) can be followed by the character * to 
make a text pattern which matches laca ^C,* S^LS successive 
occurrences of the single character pattern.! The resulting pattern 
Is called a jzifisut£« for example* a* latches ?ero or more a»s; 
aa* faatches aa^ or more a«s; Ca-zl* Hatches any string of zero 
or more lower case letters. 

Since a closure matches zero or more instances of the pattern* 
which do we pick if there's a choice? It turhs out to be most 
convenient to match the iiiuassi possible string even when a null 
string match would be equally valid. Thus Ca-zA-ZJ* matches an 
entire word (which may be a null string)* Ca-i:A*€1Ca-zA-Z3* matches 
an entire word <one or more letters but not a null string)* and •* 
matches a whole line (which may be a null string). Any ambiguity in 
deciding which part of a line matches a pattern is resolved by 
choosing the match beginning with the ilt£tia5,i character* then 
choosing the laQafiSi possible natch at that point. 

So Ca-z3£a-zO-93* matches the leftmost FOf?TRAN identifier on a 
line* !•*) matches anything between parentheses* and •.* matches 
an entire line of one or more characters (but not a line containing 
onl y a new I ine) . 

Finally* no pattern matches across a line boundary. This is 
often most natural and useful* and it preverits an unwise •♦ from 

eating up an whole file. 
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The previous discussion Introduced a i^t of ?ie« notation for 
matching text patterns and regular expressions* Here Is a sufRmary 
of what went before* 

c LLt&L^l &hML^fli&L C for example s ) 

am ati^LJaifiL except newllne 

$ fiSil af XiUfi C null string before the newllne ) 

£•••3 £l3J£J£l££ £iJS2l < any one of thiese characters ). for 

example^ CljkliinJ matches the flr*5t character of a Fortran 
integer identifier* 

^.••1 QSajiSii ^MtJfiiaH £iM& <a*l but these characters) 

* £iflSU£5 Izero or more occurrence of previous pattern) 
3c HSfiJEfiil SihMt&SLt&L (for ex amp I e* 3*» a$» 31 » 3*) 

Any special meaning of characters in a text pattern is lost when 
escaped^ inside a C«»«3f or for : 

'^ not at beginning 

$ not at end 

♦ at beginning 

A character class consists of zero or nore of the fotlonlng 
etementsf surrounded by I and 3 : 

c literal character^ including I 

a-c range of characters idigitsy lower or upper case letters) 

negated character class if at beginning 
ac escaped character ( 3" 3- 33 31t ) 

Special meaning of characters in a character class Is lost when 
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escaped or for s 

" not at beginning C for example Ca*9Jtfg1 ) 

- at beginning or end* for example t-"+52l or C+«abc-l 

Mats s the following three sufeitltSitiflQ^ tatlstas apply to the 
CHANGE utility described in the next section. A subltililtifill 
Satt^StB consists of zero or store of the foirovtlng elements : 

c literal character 

S ditto* that is* whatever was matched 

c escaped character ( 3S ) 

An fi^aa£ aS9U£!lfiS consists of the character i followed by a 
single character 2 

9n newl Ine 

St tab 

ac c ( including 9 ) 
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CHANGE changes patterns In a file. The frow and to patterns way 
be specified on the control statement* or' they may be given as the 
first two lines of an argument file* Both from and to roust be 
specif I ed» st a pattern file nsay be qlyan via the with or using 
parameter. If none of these parameters are sypalled* CHANGE takes 
Its pattern argument from file Input* Paraneters to CHANGE are i 

lor f 5 

name of input file which Is to have its patterns changed. 



from s 



to 



(optional) character string which represents the from string 
to be matched. 



(optional) character string which represents the to 
substitution string. 



with or using : 

(optional) name of a file containing the from and to 

patterns on two separate lines. This file is used If there 

are lower case patterns in the fr*on or" to parameters which 

can't be entered via the control statement. 

onto or : 

(optional) name of file to receive the QutPut from CHANGE. 

If you don't code the o parameter* the output appears on 
file output by default. 



Examples of CHANGE Usage 



ses.change myflle from •'^C0-51*« to »*1AR<«S« onto outflfe 
REVERT. END CHANGE MYfFILE -> OUTFTLE 



ses.change oldfile using patfile 
REVERT* END CHANGE QIOFILE 
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The first example shows CHANGE locating all lines that have an 
arbitrary nuiaber of digits between and 5 at tfie beginning of the 
line* and changing the pattern so found Into the string ««MARK«» 
followed by the string of digits that Mas faund.? The second example 
shows CHANGE operating on a flle^ where the pattern arguments are 
supplied via the argument file patfile. 
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17.22 lLiI-r.IglliiLiI£SAI£.£liAaALI£Ea 

XLIT transliterates characters in a file. The froii and to 
patterns may be specified on the control statenerit* or they may be 
given as the first two lines of an argument file. Both froa and to 
fl»yst be specified* a£ a pattern file may be given via the ulth or 
using parameter. If none of these parameters are supplied XLIT 
takes its pattern argument from file Input. I 5>arameters to XLIT 
are s 



I or f : 

name of Input £ile which Is ta have Its characters 
trans! i terated. 



frdw 



to : 



Coptlonal) character string which represents the fro« string 
to be transliterated. 



Coptlonal) character string which represents the to 
transliteration string. 



with or using i 

(optional) name of a file containing the fron and to 

patterns on two separate lines. This file is used if there 

are lower case characters In the frdu or to parameters 

which can*t be entered via the caitrot statement. 



onto or o : 

Coptlonal) name of file to receive the Qjtout from XLIT. 
If you don't code the o parameter* the output appears on 
file output by default. 



Examples of XLIT Usage 



ses.xlit myfile from •ABODE* to 'yMXYZ* onto outfife 
REVERT. END XLIT MYFUE -> OUTFILE 
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ses.xlit oldfite ysing patfiie 
REVERT, END XtIT OiDFILE 



This is a short suiR«ary of the facilities provided by XLIT. The 
exaiPptes beloi4 just show the fropi and to patterns. The simplest 
forra of XLIT is to simply convert one character to another* like s 

fro« X to y 

and have all occurrences of x in the input file be replaced by y 
In the output file. Multiple translations are also handy : 

from xy to yx 

changes all x's into y's and all y's into x^s. There Is also 
a nice shorthand notation 

frofli a--z to A-Z 
to translate all lower case letters to upoer case* or 

from a-zA-Z to A-Za-z 

to do case reversal. Even good typists prefer 

A-Z a-z 
to 

ABCOEFGHIJKLNNOPQRSTiJVWXYZ abcdefghl Jkf Unopqr'stiiVMxyz 

There are times when we would like to translate a whole class of 
characters Into just one character* and then ts collapse runs of 
that translation into just one instance. For exanple* translating 
spaces* tabs and newllnes into newllnes and then col I apsi ng multiple 
newlines leaves each of the words in a docjuent on a separate line* 
ready for further processing. Or we itlght want to convert all 
alphabetic symbols in a program into «•$ and all numbers 
into n«s. We specify this collapsing operation by giving a second 
argument that is shorter than the first J 

from a-zA-Z to a 
from 0-9 to n 
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The imp! I cation is that the last character in the second argument 
(the to string) is to be replicated as ofte^ as necessary to wake 
a string as long as the first argument* aid that this replicated 
character should never appear twice in succession In the output* 

xllt also provides an escape convention for* writing tabs ^nd 
netiiines so that they are visible and cause a inlnlfnufB of grief for 
programs that must inspect the arguments. We use the at-sign 9 as 
an S5Li*J£S &hML3&t&L * whatever character follows the escape 
character is in so^e way special* In partlcufart we define 3t to 
be a tab and 3n to be a newline* so we can write 5 

atan an 

to change all occurrences of «whl tesoace** (spaces* tabs and 
newiines) to just one newline and leave one word oer line. 
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18.0 ai5a£iUi£Qyi^Uif £iJL-.BQaai£l 



This section covers a number of useful SES procedures that fall 
into no other category than mi seel ianeotis«^ The facilities in this 
section are described briefly here. 

lAF sets up lAF terrnlnal defaults for* specific terminal types. 

AUTONOD automatically modifies deck natnes on a M40IFY library from 
the standard 170 length of 7 characters or less to NVE 
allOMabie length of 31 characters or less** 

DO a "control statement generator'*' that can optionally 

generate a batch job ♦•on the fly**.^ 

HATH a quick and dirty desk calculator.; 

BELL rings the belt as an attention getter. 

BYE logs out your current interactive session.? 

HEXOHP produces a hexadecimal dump of a C binary) file. 

CONCAT concatenates a list of files into a sligle file» with the 
resulting file ••packed'* Into a sligl^ "logical record". 

SCATTER performs the reverse action of CILLECT, that Is it 
"scatters** a mul ti record file to a nusfiber of individual 
f i les. 
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18.1 lAF - SET UP INITIAL lAF TERHINAL PARAiETERS 

The lAF procedure defines your terminaf to the MOS lAF facility. 
In addition^ it will notify you of HAIL80X iisssages* and updates to 
SES. INFO. 

There are defaults for all the different terilnal types* and 
noriaaMy* the user only specifies hi s/her* ter Inl nal type either on 
the proc call or in his/her PROFILE. All the strange parameters* 
including the terminal type* may be set up In your profile. As an 
example* if you're logged In to a COC 713 ter*!iiinal» you can set up 
the terminal controls by simply typing : 

ses.iaf terfli«cdc7l3 

The table on the next page describes the parameters for lAF* the 
defaults* and the profile variables that you can set to change the 
defaults chosen by the lAF procedure. 

Mala 2 while the lAF procedure is rumi ng** la aat hit carriage 
return {CR3 to find out what's going on* even If It does seem a 
little slow. At the time of writing* due to the way the NOS TRHDEF 
command works* hitting a carriage return iTterferes with the TRMOEF* 
which will issue a line of garbled data to your terminal* and the 
TRMDEF command gets Ignored. In other words* the lAF procedure 
won't do anything. 
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18.1 lAF - SET UP INITIAL lAF TERHINAL PA^A^ET^RS 



4, , -< 4 , «4 «««. -4——. . .- «. 

• ternif t J No Default t term I Ter*^lnal type. For a 
I » * ; fist of the terminal 
I i * I types currently 
S t f 1 recognized by the lAF 
t * 1 ! praceduret see the list 
1 1 « 1 at the end of this table. 


» 1 ft process* 


1 termchrf tc \ see belon « teraichr * Character to TERMINATE a 

J I * ; or'bcess. 

A .. ..... ... .._ . . t -. .. ... . *. . ... H ._^_,__._,_,_^_, __.,_-,__,— ,«.-_— __,__,__,_,__. 


J canchr» cc J see below » canchr * Character to CANCEL a 
; J ; 1 line Input at the 

; conchr^ ct * see below * conchr J Cfiaracter to use as a 
J S I • C1*5T^QL character when 

• i » i giving coi!!Jands Csuch as 

• i « •pagewaltonoroff)to 
J 1 ; i the TIP. 

4 ^ 4. 4. ^ 4 . . —^ 

• bschr# bs J see below • bschr \ Citaracter to use to 
J 3 * Idelete previous Input 
J J « • character.^ 

i widths pw I see below 1 width * Oeterulnes fnaximum number 
! ; ! ; of characters a terminal 
% • 3 1 can print on one output 
J J S J line. 


« lengthy 1 en 3 see below t length « Oeterinl nes ffiaxlmum number 
! 3 3 3 of lines that can be 
3 3 3 3 printed as one page. 

3 pgwaity pg 3 no 3 pgwait 3 Deterffllnes whether page 
3 5 3 3waltlni Is to be 
3 3 3 3 performed for the 

3 3 5 3 terminal* 


3 3 3 3 terminal Is to run In 
3 3 3 3 H^LF or FULL duplex. 
3 3 3 3 These are Just li£je5« 
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18.1 lAF ~ SET UP INITIAL lAF TERMINAL RA^AIETERS 



ci 



ci 



Carrf age 
count for 



return 
IST3 or 



idle 

TI745. 



II 




li 



Llie feed Idle count for 
ISn* TI?%5 or CDC751« 



hardcopy 



hardcopy • If you* use a hardcopy 

i device on yoyr IST3> the 

J defaults for cl and H 

! are changed to 50 each* 



The defaults 
hy lAF Cpart 
have copped out 
froiR tiffle to 



given above* nawely "lAF default*** are those chosen 
of NOS)# as opposed to lAF (the SES procedure). We 
by not stating what they are heret since they change 
time. For a list of the defauttsf consult the lAF 



reference manual* or see your local NQS wizard. 

The terra <for terailnan profile variable 1^ set up when you use 
8L0RR0F (BuiLD PRQFile)* and the lAF procedure uses this profile 
variable. If you use the lAF procedure arid no terwlnal type Is 
specified* either via the term parameter or the term profile 
variable* lAF prompts for the terminal type. You can edit your 
profile to insert all the other defaults If you wish. 



Terminal 
are t 

C0C713* 
NCR620* 



types that the lAF procedur'e knows about at present 



CDC722, CDC722A* CDC751, C0C752* 0X132A* DC300* DATAPAC* 
TI745* TTY43* 0ECtf3* TEK4014* IST3* :DC721, Z19* 
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18.1 lAf - SET UP INITIAL lAF TERHINAL PA^A^ETERS 



The table below describes tbe control characters and other 
pararaeters that the lAF procedure establishes for you. ijnifi • that 
a page nldth of zero (01 aliOMS the maxlmuti page width. 



JTERH- ICONTROLJCANCELSINTER-ITERH- S BS tPASE 1 P AGE5 P ASEI ECHO-J 
JINAL I CHAR J CHAR IRUPT 5INATE 1 CHA^ tWX^fHfLEN SHAITfPLEX [ 
UYPE I t rCHAR rCHAR I f I I 5M00E I 

I ; * s * J ♦ I * ! » ? * t ♦ 5 ♦ i ♦ J 

+— ^ -. + , -.— + ™-.|.— .-- .-^4—.- —4. ^.-.-™«f«. 4.- 4.-— 4. 

JCDC713 lESCAPE JLINE ISTX ,'ETX JBS I J 16 } N IFULL J 
I J i CLEAR J I I ? r J S J 

4.-««- -4. 4. -^ 4.-. -4. 4. •.-..4.— 4.-.,«^«4. •4.«.«— ^4. 

!C0C722 JESCAPE S EQL ICTRL/PfTAS IBS I I ?4 S H JFULL 1 

4.— ™— 4.-.«« -.«4.««™^4.-.« ^.4.^ 4. •.4., «4.« ^4.-., 4. -4. 

JC0C722ASESCAPE J EOL '.CTRL/PUA8 lEM t D T 24 J N IFULL J 

4™ « 4--~« «4.— . 4.-, ^•4.- — «4.— ^-^...f-.- . ^4. 4.-^— .4.-^-4. 

JCDC751 lESCAPE I GS SCTRL/P JCTRL/TSBS I ! 24 S N JFULL S 

4. -. 4. » «4.«^— .— 4.-.— . 4.»«^-.«-4.™^^^4.».— : 4.-^-.-.4.« 4. 4. 

SCDC752 JESCAPE J CTRL/X JCTRL/P JCTRL/T5 BS J J 24 J N JFULL J 
5Z19 J J J J J 1 r J S J 

4.—^— 4-™ ^-4.™- -.4.--^« 4.«^«- 4.-.- —.4. f — 4. —.4.- 4. 

JDX132A I % JCTRL/XICTRL/PJCTRL/TJBS J 132 J 30 I N JFULL J 

4.-, -.«4. -. «4.«« — 4.*— «««.-.4., 4.™.«^^4. ^, 4. -«4. «4.«— .^-.4. 

J0C300 JESCAPE ! VT IFF JHT JCTRL7HI 118 1 N/AS N/AIFULL J 

4. « -4.-.^ . 4., ^-4.—.-. 4„, „4.-. ^.4. .-.-.4.-.^ ^4. «-.4.« —4. 

JOATAPACJESCAPE S CTRL/X3CTRL/P J CTRL/T JCTRL7HJ t N/AJ N/AJHALF J 

4. ——^4. -».4.— — ^-.4. -4. — «4.— ««^.«««,-^f «.^.«-.4.-.«„^4. -4. 

JNCR260 J J S J J J J J J J 

3TI745 I I J J J J J J J J 

JTTY43 JESCAPE J CTRL/XJ CTRL/PJCTRL/TJCTRLYHJ 5 N/AJ N/AJFULL J 

J0ECW3 J J J J J ? t J J J 

4. »-.«-4. 4. 4. 4.- 4. •^-,-...4.-— ,-^4..^ 4. 4. -^-4. 

JTEK4014JESCAPE J CTRL/XICTRL/P J CTRL/TJCTRL/H? D J 64 J N JFULL J 

4.-.«™ 4. — «4. «-- — 4.«— -«-4.-«— — 4.-^— ^-+-^™4..«^«.4., -«.4.-^« 4. 

JC0C721 JESCAPE J CTRL/X SCTRL/P JCTRL/TJCTRL/HJ J 30 J N JFULL J 

4. 4. 4.. 4.-. «.4.- —.4. 1.— 4.»^«-.4. •«4... 4. 

JIS13 JESCAPE JCTRL/XJCTRL/PJCTRL/TJCTRL/HJ 3 J 34 J N JFULL J 



The default values can be changed by coding a parameter that 
corresponds with one of the columns marked with *. If half duplex 
Is desiredf simply code the half Isfli. 

tiQ.tSi • when specifying an octal code to ch^ncje a default valuer 
remember that the radlx^ enclosed In parentheses* must follow the 
number^ for example ' 

conchr»33<8) 
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Mutfi • character values can be changed by anterlng the desired 
character enclosed In string quotes Capostr 9ohes)f instead of octal 
numbers* 
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18.2 AUTOHOO - AUTOMATIC HOOIEY TO SCU NA^E CHANGE GENERATOR 

AUTOHQO is a MODIFY library to SCU library tool that eases the 
conversion process by automat I oa i I y det 3r*!il r^l ng the 31 character 
deck naffles when a standard way of determlf^at 1 on exists. The output 
of this process is a file of comiaands that i^ turn can be used as 
input to the SCU conversion coiaroand* CQ^<IERT_modIFY.TO_SCU. This 
reduces the number of deck nawes that must be cha?iged manually (one 
at a time)* Note that AUTOMOD can potentially be jnable to handle 
extiia large libraries. It is suggested that fwerely creating two 
libraries* each with half the decks* should soly« the problem. 
Paraffieters to AUTOMQO are s 



b or i 



name of Base Library containl'^g the MODIFY decks to be 
searched for the long name. 



Coptional) name of file to receive the Output from AUTOMOD. 
If you don't code the o par*tiet«!r# AUTOHOD places the 
output on the file NEyNAME. 



un : 

(optional) User Name in whose catalog the base library 
specified by b exists. 

The program uses a simple algorithm ta do the translation. It 
searches the deck for a procedure name with the saiae first two 
characters as the deck name. The SIS specifies the legal types of 
decks and the coding of the short nanes. *5« decks do not 
consistently contain an identifiable choice for the long name* so no 
attempt is made to find one. «X« decks coitain the XREF declaration 
for a procedure or function and this name Is used as the long name. 
»H* decks contain a commented explanation of the *K» deck and the 
procedure name is simply searched for and used with »H« substituted 
as the third character to distinguish them from the long names for 
the 'X* decks. 'E* decks have not been C9nslstently used for the 
same purpose* but most of them end up with the likely long name 
anyway. '«• decks should end up with th-; long nodule name off of 
the same line as the keyword MODULE. *A» decks should work the same 
off of the word ASSEMBLY. 
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18.3 fiQ.=-£QiIEQL«SIAI£E£MI-SIIi£EAiaE 

00 accepts a list of character strings* 3r a fiie of commands* 

and outputs them to the NOS control stateiefit streai. The stream of 

commands so generated may be submitted to the batch system if 
desired. For example s 

ses.do i «r eMlnd^*«#»get*«yf I leS •dlspose^iiyf I f 8«pr** 9 *ses.cati ist«l 

Aft sorts of NOS control statements may be given as parameter values 
to the 00 procedure. Note that a per f ectly vali d DO parameter value 
Is a call on SES processor itself* so that if you were feeling 
sufficiently playful* you could code lines like : 

ses.do «ses«do ••ses.cati I st«** 

Parameters to 00 are 2 



cs 



(optional) list of Control Stateients to be output to the 
control statement file. 



{optional) name of file contalnMg cor»trol statments to be 
executed. If you don't code the I parameter* DO prompts 
you to enter the statments froni file Input. Coding the I 
parameter causes DO to submit a batch job containing the 
stream of commands from the file. 



{optional) name of Library in which the text record given 
by the i parameter may be found. The library myst have a 
directory. You use this feature to place canned streams of 
JCL (such as build jobs) In a LI8E0IT style library. See 
the chapter on LIBRARY FILE MA^IAGEMEMT JSING LIBEOIT for 
hints on how to manage LIBEDIT libraries. 



(optional) User Name in whose catalog the file given by the 
I parameter* or the library given by the U parameter may be 
found* if it is not in the current user^s catalog. 



f or file or files J 

(optional) list of LOCAL FILES that are to be copied onto 



un 
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the end of the job file if DO is being used to create a 
batch job <one of the batch* batchn or defer |<sis a'' e 
codedK If yoii code any values for* the flies parameter* 
DO generates the job control to COPfBF each of the local 
files onto the end of the Job fife before SUBMITTING It 
and also generates the control state?iients in the jobfile 
itself that are necessary to CO'^fSF those files from INPUT 
when the Job runs* If any of the filenames coded for the 
flies parameter are not assigned to the job when you code 
the ses«do statetnent* the 00 procedure aborts with ^n 
error mess age • 



batch Job parameters s 

These parameters are described l^ the section entitled 
"SES PROCEDURES RUN AS 8ATCH JOSS", The default for this 
procedure is to run in local modet but It can be run in 
batch roode. The dayfile parafneter* is not used by this 
procedure* 



Example of Using DO to submit a batch Job 



ses«do f^ses^gencomp nilnclud*f *ses*lcybll*» ^^ 
•ses.print listing** *saye»lgo*)# batch; bye 

10.23,56. SUBHIT COMPLETE. JQBHAME IS ABLEB3D 
REVERT* 40B 00 SUBMITTED 



The four control statements (mostly consisting af SES procedures 
of coursei) are built into a batch J3b and subinltted. The bye 
procedure then logs you off* 
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18.4 Mia«rUiaiiEiaiM£«imi0M0>£4L£ilLliaE 

MATH i s an SES procedure that Interacts v«lth the user to provide 
a "quick and dirty* interactive calculator* Only Integer arithinetic 
of 48 bits precision Is provided. 

MATH works on the concept of the £y.C.Lfiat ^ILilllll* When HATH Is 
started* It starts with a variable called VAttlE* *fhose value is 0. 
Every tlrae an expression is assigned to a variable* that variable 
becomes the current variable* An asslgnieTt statement with no 
variable nawe on the left of the operator assigns the expression to 
the current variable. Type END to terminate this procedure. Valid 
entries are J 



« expression assigns the value of ••expression" to the current 

var i ab I e. 

-••expression adds the value of '•exorssslon*' to the current 

var i ab le« 

-expression subtracts the value of '•expression'* from the 

current variable. 

♦ expression fliultiplies the current variable by the value of 

"expression** and asslgr^s the result to the 
current variable. 

/ expression divides the current variable by the vaiue of 

••expression" and assigns the result to the 
current variable. 

// expression perforais the calculation current var i abl e MODULO 

"express ion*^ and assigns the result to the 
current variable. 

** expression raises the current variable to the power 

"expression" and assigns the result to the 
current variable. 

name « expression assigns the value of "exoressi on" to the variable 

specified by "name"* which then becomes the 
current variable. 
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18.5 BEil - ATTEHTIQN GETTER OR WAKE UP 

BELL is a useful facility for ttiose users «r>^5 fall asleep at the 
terminal. This 8€Li procedure ••rings the bell" a specified number 
of times. Parameters to BELL are s 



is the CoptionaU number of times to '•rifici the bell**. If 
you don't code the n paraiseter> BELL rings tuice. 
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18.6 ai£-r-Lfl£-Qyi 

BYE is an SES procedure that sends a special co'^trol code to the 
user's terminal* to log It out. This provides the useful facility 
that you can set a streara of SES pr ocedur es* golia* w I th ttse last one 
being 8Y£# and you can then walk aiiay fron the terminal and let the 
systeffl get on with the Job» For example* the following is a fairly 
typical sequence s 

ses.genconp themodll compassi print I istlngr *save»l go* | bye 

The example shown GENerates a COMPils fil* for module themodlf 
compiles it with the COHPASS assemblerf PRI^IfS the listing output of 
the asseroblerf saves the binary output of the asseibler on file lgo# 
and finally logs the terminal off via the 8YE procedure* The 
progr atniner is able to type that line of SES procedure calls* then go 
and have tea while It's all happening* 
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18.7 liIMi£.r-.SIiaiE4I£.a£iL^a££iaAL-.Mi£ 

HEXOliP prodyces a printable duwp of a binary fit%. In the dump* 
CYBER Hords (addressed in octal) are sho^ti In hexadecinal witb 8/12 
ASCII interpretation. Parameters to HEXD^^ ^re s 



nawe of the local file from which to produce the dump. 



o : 



na»iie to be used for the local file containing the 
printable dump* 



P or t s 



(optional) type of dump to produce s 
P printable - 8 words per line for* fine printer 
T terminal - 4 words per line for terminal output 
(default) 



a or h : 



these (optional) jn&^is, determine If ASCII Interpretation of 

the dump Is to be included in the outout.? If you code the 

a liSi* ASCII is included - this is the default action. If 

you code the h Jssi (Hex only) Kfi^* ASCII i;sQflt included in 
the dump. 



Exanpie of HEXOHP Usage 



ses«hexdiiip filel tlist t 
REVERT. FILE OUHP COMPLETE 



This command creates a file 'TLIST* suitable for displaying on a 
terminal showing the contents of file 'FIL?!' In hexadecimal. 
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18.8 £aM£AI-=«aQiCAI£ilAI£-.£iLIi 

CONCAT concatenates files onto a single "gr*oup'« file. It Is 

similar to COLLECT except that CONCAT wor1<s with flies Instead of 

records* and the resultant group file is PAC<ed upon completion of 
the process. Parameters to CONCAT are s 



I or f s 

Is a list of names of files to be concatenated onto the 
group file. 



9 or group 3 

{optional) name of group file to receive the final 

concatenated set of files. If you doi»t code the group 

parameter* CONCAT uses the value 9f prc)fH?e variable group* 

and if there's no such variable defined* uses the name 
group. 



msg or nonsg : 

these (optional) lllJtS. control the generation of 
Informative wessages by this procedure and are fully 
described in section entitled "lsiPOR'iATI\f E MESSAGES FROM 
SES PRQCEOURES". 



Examples of CONCAT Jsage 



ses.concat imyf it e*hi sf 1 1 e*anyf i le) 

* HYFILE -> GROUP 

* HISFILE -> GROUP 

* ANYFILE -> GROUP 

REVERT. END CONCAT MYFIIE,. ANYFILE -> SR3UP 



ses.concat lgrab*hold*grl p*clutch} g^titefln* nomsg 
REVERT. END CONCAT GRAB.. CLUTCH -> TITEFIN 
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18.9 SCATTER - SCATTER A HULTI RECORD FILE TTJ OTHER FILES 



18.9 ilIiII£E^r-.Si:iII£i.A«llUiII-af £ata-£ILE-Il -IIMEI-IILES 



SCATTER copies the records of a i»ulti record fife to a inuwber of 
other files. Far aaieters to SCATTER are ? 



or f t 



9 ot 



nr 



fist of nai^es of £iies or Heuiber f i les to which the records 
of the single file are to be copied. Mamas may appear in 
the list more than once» if you want to divert sundry 
records to the same file. 



group 3 

(optional) name of GROUP file contalnirig the records to be 

copied. If you don't code the g parameter* SCATTER uses 

the value of profile variable group* and If there's no such 



variable defined^ uses the file nane <irouP. 



if you code this Coptional) iiSi* SCATTER does aal rewind 
the group file before starting the copy sequence. If you 
don't code the nr li£i» SCATTER rewinds the group file 
before doing any copying. 



Examples of SCATTER Usage 



GETMAIL.^TEXT 
CAPS99g.*fEXf 



COMPARE. .TEXT 



ses.catalog neMprox 

GETPXDB..TEXT TOOIDOCTEXT 

GENCORS..TEXT GENRE VB..TEXT 

REVERT. END CATALOG NEMPROX 

ses. scatter <cerfoic*varfi8l»tay}ot»cerblc»viar*nel> eerbl c^footle)*.... 

••? g«neHprox 

REVERT. END SCATTER CERBIC. .FOOTLE <- lEHPROX 

ses.catalog cerblc 

GETPXOa..TEXT COMPARE ..TEXT GENREVB.^fEXT 

REVERT. END CATALOG CERBIC 

ses.catalog varnel 

TOOLOOC..TEXT 6ENCQRS..TEXT 

REVERT. END CATALOG VARNEL 



The example shows how SCATTER Is used to seoarate the records 
from the file newprox onto the different files given in the list on 
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the SCATTER call. The CATALOG procedures are used here to show the 
"before and after" effect of SCATTER. 
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19.0 aMSLIM(i,y£i24I£-£EQiiEii«LI2£iSl£i 



For those who yse UPDATE as the source text maintenance regime 
for software devel opaient* the set of SES oroce^Jures described below 
sypply a fairly easy to use interface to JPDATE, A short suiRiaary of 
these SES procedures appears firsts i^fth the laore detailed 
descriptions following. The SES procedures to driye UPDATE are as 
f ol I ows 5 



GENUPCF Mtierate yPdate £otpplle £iie» Generates a coinpile file 

for specified decks with Jiiodsets optionally applied* 
Either a Quick mode or Full mode JPDATE can be performed. 

GETOECK MI M£liis) for editing. This is intended as a 

preli?ainary to a GENHOOCS) procedure usage In order to 
generate modsets* 

6ENM0DCSI SEierate iOaif icatlon lets for decks on a PL. GENMQOS 
uses the SCOOP utility to compare two files and generate 
UPDATE modification directives* 



GENUPSF ££}lerate UEdate Source file. A source file raay be 

generated for specific decks or coupon decks* with 
modsets optionally applied* 



UPDATE applies a list of raodsets to an ^Id orociraro library and 

creates a new program library* 
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The ypdate procedure interfaces use only three profile variables* 
but these are of great utility when you're working on the same PL 
for long intervals* The profile variables are ? 

oldpl name of the program library to be used when generating 

compile files* edit files and so on.i It Is the default for 
the pi or oldpl parameter on the ofbcedures. 

newpl name of a new program library ^hen ruining the UPDATE 

procedure* It Is the default for 

the npl or newpl parameter on the Ui^DATE procedure* 

piOMfier £L OMM£E *s the user name of the catalag in which the 
program library resides* It Is the default for 

the un parameter on all the procedures* 

updtmcc UEfiale ffaster Control Character* If you're working with 
such things as 'slash PL's'* this profile variable is 
useful for overriding the standar'd waster control character 
which is the asterisk <♦) character* 
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In order to get the best use out of the UPDATE interface 
facliitiesf It Is anticipated that users vii 11 fol low the sat of 
Morklng procedures outlined below. 

Most of the procedures work on the concept of applying roodsets 
to an existing prograw library* and only making a new program 
library at fairly infrequent IntervalSf say once every two 
weeks or so. This allows many !>9ople to be working on 
unconnected decks at a tlrne* with one person controlling the 
building of new program libraries* 

o To make modifications to a deck* use SETDECK to generate an 
EDIT FILE (plus a COMPILE FILE)? edit the edit file, then use 
GENMODiS) to generate modsets w*ifch can then be used In 
subsequent GENUPCF runs. 

o To make major changes to decks* use 3E1!JP$F to get the source 
of the deck out* and edit that. 

The working scheme suggested here has been In use* successfully* 
for some time. It Is far easier to comprehend and handle than It Is 
to be 'fflanually' creating correction sets.^ Plctorially* the scheme 
looks something like this J 
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To show how this goes In practice^ on the next page there's an 
exanipie of a complete session of work Invofvlnci the three widely 
used procedures GETOECK* G£NHOD<S) and GE^U^CF. We want to generate 
modsets for decks "delta"* and "fnu" through "phi". User typing Is 
In lower case* and HOS messages in UPPER CASE. It Is assumed that 
the program library - PRQGLIB - is specified In your profile. 
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ses« get deck d'fdeltaf Riy««phi } 

* GENERATING COHPIIE FILE COMPILE 

♦ GENERATING EDIT flLB EDTFILE 

REVERT. END GETDECK EDTFILE* COMPILE <- 5>RQGL1B 



edit*edtfile 

• • • 

editing 
session 

EDIT, EDTFILE 



ses«9en«iods anymods jan0d79 cd«(det tat niu««l>hl ) 
REVERT. END GENMOO COMPILE JEDTFILE -> A^IYMODS 



ses.genupcf anymods 

* GENERATING COMPILE FILE COMPILE 

REVERT. END GENUPCF COMPILE <- PROGLIB 



As you can see from the exansple^ the a^otj^t of typing yoy do is 
snially there are in fact only four coiniands (excluding the actual 
edit session coromandslt the system does tha rest. 
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19. 1 ££MUE££-r-S£M£EAI£-y£aiI£-i:OllEiL£-£lLi: 

GENUPCF generates a compMe file for any soaclfled decks on an 
UPDATE prograifl library* Hodsets can be aopfled also. Parameters to 
GENUPCF are : 



n or mods : 

is an (optional) list of names of files containing modsets 
to be applied against the PL when generating tNe co^npile 
file. One or both of the mods Parameter and tbe d 
paraiieter fflMSl be specified. 

d or at I i 

is an (optional) list of deck narnes to be placed on the 
cosipile file. If the ail Jifii Is coded» this implies a full 
update in which case as d&fili aai5s^!sakii liS a£a£i£iSi4« 
One or both of the mods and the d parameter liiSi be 
speci fled. 



cf 



(optional) name of the file to receive the Qompile £ile« 
If you don't code this parameter* the compile file appears 
on a file called compile* 



pi or oidpi : 

(optional) name of the UPDATE proqran library from which to 
generate the compile file. If you don't code the pi 
parameter* GENUPCF uses the value of orbfife variable oldpf 
as the name of the program library*' and if there's no such 
profile variable defined* uses the name oldpl* 



un t 



(optional) name of user In whose catalog the program 
library resides* If you don't code tNe un parameter* 
GENUPCF uses the value of profile variable plOMner (PL 
OyNER) as you name* and if there's no such Profile variable 
defined* GENUPCF uses the name of the curr'ent user* 



status or sts : 

these (optional) KfilS are used for those cases where 
GENUPCF Is being used as a building block of a larger 
procedure* The NOS job control register EFG is set to zero 
(0) in the event of a successful comoletion* and to non 
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zero If the UPDATE process bowbs far any reason* If status 
is not specified and an error occjfs* the procedure £XITs» 



Msg or noflisg : 

these (optional) liJis control the generation of 
Informative messages by this arbcedure and are fully 
described in the section entitled "INFORMATIVE MESSAGES 
FROH SES PROCEDURES'*. 



me 3 



(optional) Master Character to be used instead of the 
standard master character (♦). If you doi»t code the nc 
parameter* GENUPCF uses the valje of profile variable 
updtmco and if there's no such prbf H e var i abl e# uses the 
default master character asterisk (♦)• 



Exanpies of GENUPCF Usage 



ses.genupcf modfile 

♦ SeWERATING CONPIiE FILE COHPILE 

REVERT. END GENUPCF COHPILE <• HOLDPL 



ses.genupcf fli«(iROdsl9iiiods2lf d»( al f digywhlfes* def Inesif pl«anypl 
* GENERATING COHPILE FILE XPANOEO 

REVERT. END GENUPCF XPANOEO <- ANYPL 

The first example sho«s the simplest usage of GENUPCF to generate 
the default compile file compile from a source program library 
called notdpi (JJaster OLUEL) whose name i s ar'esumaljl y defined In the 
user's profile. The compile file Is generated by applying the 
modsets In the file modfile. 

The second example shows a slightly tare complicated situation 
where you are applying a list of modsets aid specifying a list of 
decks to be placed on a compile file called xpanded. The compile 
file is to come from a source program library called anypl. 
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SETDECK is used to produce two files from nn- UPDATE program 
library : a cowpiie file with sequence numbers and an edit file 
without sequence nujRbers. TNe edit file Is altered using an editor 
or suchlike. The two files can then be used as Inputs to GENMOD(S) 
to produce UPDATE correction sets. Parameters to SETDECK are s 

m or mods : 

is an loptional) list of nawes of fifes containing n^odsets 

to be applied against the PL when generating the compile 

and edit files* One or both of the mods parameter and the 

d parameter lUst be specified. 

d or decks or c or cons or all s 

is an Coptional) list of deck ar* common deck names to be 
placed on the compile and edit files. If the all \i^x Js 
coded* this implies a full update In «hlch case QSi d&£ll 
asiSS SllSilld k& S2££i£i&^* One or both of the mods and the 
d parameter and the mods parameter* lusJ; be specified. 



ef 



Coptional) name of the file to receive the £dit £ile. If 
you don't code this parameter* the edit file appears on a 
f i le cal led edtf I le. 



pl or oldpl : 

(optional) name of the UPDATE program library from which to 
generate the compile file. If you don't code the pl 
parameter* GETOECK uses the value of profile variable oldpl 
as the name of the program library* and if there's no such 
profile variable defined* uses the name ofdpl. 



un t 



cf 



(optional) name of user In ^'lose catalog the program 
library resides. If you don't code the un parameter* 
GETOECK uses the value of profile variable plOMner (PL 
OWNER) as you name* and if there's io such profile variable 
defined* GETDECK uses the name of the current user. 



Coptional) name of the file to receive the compile file. 
If you don't code this parameter* the compile file appears 
on a file called compile. 
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status or sts i 

these < opt I on ail l£5XS are used for tfiose cases where 

SETDECK is being used as a building block of a larger 
procedure. The HOS job control register EFG Is set to zero 

COI in the event of a successful completions and to non 

zero if the UPDATE process bombs for ar^y reason. If status 

is not specified and an error ocsursf the procedure EXITs. 



fflsg or nomsg s 

these <optional) !i£is control the generation of 

infor«?3tive messages by this procsdur'e and are fully 

described in the section entitled "INFORMATIVE HESSAGES 



mc 



FRQil SES PROCEOURES«. 



(optional) Baster £haracter to be used instead of the 
standard roaster character (♦). If you doi»t code the wc 
paraffleterf GENOPSF uses the value of profile variable 
ypdtfliccs and if there's no such profile variable* uses the 
default master character asterisk C»l. 



Example of GETOECK Usage 

ses* get deck ( 1 1st » off todays finodsetsytoy ap9Y¥» against^ thetpt ) 

♦ GENERATING COMPILE FILE COMPILE 

* GENERATING EDIT FILE EOTFILE 

REVERT. END GETDECK EOTFILE* COMPILE <• SOLDPL 

This example shows a whole raft of moisets apafled to a program 
iibrary whose name you defined as SOLOI*L (Super OLDSi) l'^ the 
profile. The compile file and edit file naiies take their defaults 
of coflipile and edtfiie. The edit file edtflle may now be edited to 
provide a basis for a GENHOD(S) run to generate soie more modsets. 
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GENMOOIS) uses the SCOOP utility to compare two files - a new 
file and an old compile file with sequence lu^nbers - and produce an 
UPDATE correction set which can subsequently be used by the other 
UPDATE interface procedures. Paraineters to SEN'IODCS) are s 

m or mods : 

(optional) narae of file to receive the generated modsets* 
If you don't code the m parafneter» SENH3DCS) places the 
generated ^odsets on a file called nodsets*' 

I or id or ident : 

(optional) name of the IDENT to io!>ear as the first line of 
the generated modsets* If yoj don't code the ident 
paraflieter* the Ident na^e defaj*lts to that of the file 
specified by the « parameter. 

c or cd 5 

(optional) Compile directives are the name(s) of deck(s) to 
be compiled when the fflodsets are eventja I I y applied in a 
compile file generation. Ranges af decks nay be specified. 



n or new : 

(optional) narae of the HEW file (the edited file without 
sequence Idents). If you don't cade the new parameter* 
GENMOD(S) uses edtfile* which is the default edit file name 
generated by GETDECK. 



or old : 

(optional) name of the QlO file (coiiplle file with sequence 
idents). If you don't code the old parameterf GENHOO(S) 
uses conipilef which is the default camoile file name 
generated by GETDECK. 



mc 



(optional) Master Character to be used instead of the 
standard master character (*). If you doi't code the mc 
parameter* GENH09(S) uses the value of profile variable 
updtmcc* and If there's no such orof I I e var I abl e* uses the 
default master character asterisk {♦)• 
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Examples of GENHQOfSI isige 



ses.gennods n«today id«Jan08 cd«(decka9dek4listl 
REVERT. £H0 GENMOOS COMPILE* EOTFILE •> TUDAf 



ses«gen«iods tuesday Jati09 netisgood old»broken 
REVERT. END GENMOOS BROKENtGOOO -> TUESOAf 
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19*4 MMll£i£^=-S£M£EiI£-ii£01I£-SQyE££-£IL£ 

GENUPSF generates a source file for any spec i tied decks on an 
UPDATE prografR library. Modsets can be aat^l led al so . Parameters to 
GENUPSF are s 



m or «ods ' 

is an Coptionall list of names of files containing modsets 
to be applied against the PL wNen generating the source 
file. One or botb of the aiods Parameter and the d 
pa raise ter liiit be specified. 

d or decics or 

c or corns or 

al Ideck or al tcom : 

Is an (optional) list of the tNlngs to be placed on the 
source file, d or decks Is a list of 2£CiS to be placed on 
the source file* c or cows Is a list of illliQi ]2££iiS to be 
placed on the source file* Codling the alldeck or the 
al Icom ^&}is indicates that a full mode update Is to be 
performed* in which case afl i&^t 31121 Sliaaiil kS, 12S£iti£d» 
One or both of the wods and the decks parameter liisi be 
sped f i ed. 



sf J 



(optional) name of the file to receive the Source £ile. If 
you don't code this parameter^ the source file appears on a 
file cai led source. 



pi or oidpi t 

(optional) name of the UPDATE pr^iQrnm library froiR which to 
generate the source file. If you don't code the pi 
parameter^ GENUPSF uses the value of profile variable oldpl 
as the naffie of the program library* and If there's no such 
profile variable defined* uses the nane oldpl. 



un : 



(optional) name of user in whose catalog the program 
library resides. If you don't code the un paraffleter> 
GENUPSF uses the value of proflTe variable plowner (PL 
OWNER) as you name* and If there's no such profile variable 
defined* GENUPSF uses the name of the current user. 
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status or sts i 

these {optional) Jsi:iS are used for those cases where 
GEHUPSF is being used as a building block of a larger 
procedure. The NOS job control r eg! ster* EF^G is set to zero 
CO) in the event of a successful co?flpletion# and to non 
zero if the UPDATE process borobs for any r'^nson* If status 
is not specified and an error occurs* the procedure EXITs. 



nsg or nomsg t 

these (optional) ^SXS. contrljl the generation of 
informative messages by this procedure and are fully 
described in the section entitled '•IMFOR^ATIVE HESSA6ES 
FROH SES PROCEDURES". 



mc 1 



Coptionai) Master Character to be used instead of the 
standard waster character I*). If you don't code the mc 
parameter* GETOECK(S) uses the yalue of profile variable 
updtmccy and if there's no such oroflle variable* uses the 
default master character asterisk (♦). 



Examples of GENUPSF Usage 



ses.genupsf c«* gi tSncs** pl^mcsptf unsJeJOlO? 
* GENERATING SOURCE FILE SOURCE 

REVERT. END GENUPSF SOURCE <- NCSPL 



ses.genupsf (iiiodsone*iiiodstwo)# d«deckone..decktwo» s«neiiflle 
♦ GENERATING SOURCE FILE NEUFXLE 

REVERT. END GENUPSF NEMFILE <- OLDPL 

The first example shows GENUPSF used to place a common deck onto 
the source file (which defaults to source since it wasn't 
specified). Note the use of string dsllmlter's <♦) because the 
common deck name gitSmcs has a $ sign in it. Also in this 
example both the program library name and user' name where it is to 
be found are specified. 

The second example shows a pair of modsets being applied to the 
program library called oldpl in order to generate a source file for 
a range of decks deckone thru decktw'Of with the source file 
appearing on a file called newfiie. 
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19.5 M£MI£.r«U£0Mi«£E0SMi.LISgMI«MlIH,^lilSi:ilim»SOiM 

UPDATE applies a list of modsets against ari old program library 
to produce a new program library in UPDATE format.? The old and new 
program library names can be the same* in i^Silch case the old program 
library is rewritten, ^SitM * that program I Ibr ary creat I on Is the 
Q.!XLl function performed by this UPDATE arocedurs - simultaneous 
compile file generation is Qfii done. Parameters to UPDATE are 8 

mods or A : 

list of one or inore file(s) C3itair»fng the HQDIfication 
Set{s} to be applied against the prbgrain library specified 
by the pi parameter. 

pi or oldpl : 

(optional) name of OLD Program Library to be updated from 
the correction set file* If you do?^*t code the pi 
parameter* UPDATE uses the value of profile variable oidpl 
as the name of the program llbrarV» and If there's no such 
variable defined* UPDATE uses the default name oldpl. 

npl or newpl : 

(optional) name of Ne** Program Library to be created when 
the update has been completed. If you doi't code the npl 
parameter* UPDATE uses the value of pr*oflle variable newpl 
as the name of the new program library* and if there's no 
such variable defined* UPDATE writes the new program 
library o>fer the old program library specified by the pi 
parameter. 



un : 

(optional) User Name in whose catalog ti^e program library 
specified by pi/npl is to be fou^d* If pl/hpf is not in the 
catalog of the current user. Tf you don't code the un 
parameter* UPDATE uses the value of profile variable 
plowner as the user name from whose catalog the program 
library Is to be obtained* and if there's no such variable 
defined* UPDATE uses the current user's catalog. 

lock or noiock : 

these (optional) parameters deter'nine whether the program 
library update process Is interlocked against simultaneous 
updates; coding a filename for the lock parameter 
determines the name of the Interlock file.! Interlocking is 
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the liglauii actlor^ when the pr ograi 1 i br arV being updated 
is In another user's catalog. If you doi't code either of 
the lock or nolock ii£^s> i nter I ocklnci Is controlled by the 
lokmode profile variable. Refer' to the introductory 
sections of this chapter for* Infor'mation on the 
Interactions of the lokaode profile variable and the lock 
and nolock parameters* If you do^'t code a filename for 
the lock parameter* the contents of profile variable 
intrlok Is used as the interlock filenaie; if there's no 
such profile variable* the ns^me intrlok Is used as the lock 
fllenanie. The interlock file lusi be in the same catalog 
as the program library being uodated. If the interlock 
file cannot be found* the orocedare aborts. 

status or sts s 

these (optional) I1S3LS. a^^ used for* those cases where UPDATE 
Is being used as a building bfack of a I arger procedure. 
The NQS Job control register EFG Is sat to ^ero COI in the 
event of a successful completlanf and to non zero if the 
UPDATE process bombs for any reason. If status is not 
specified and an error occurs* the procedure EXITs. 



nsg or nomsg : 

these (optional) is^ia control the generation of Informative 
messages by this procedure and ara fully described In the 
section entitled «IHEORNATI/E MESSAGES FROM SES 
PROCEDURES". 



nc i 



(optional) Jlaster Character to be used Instead of the 
standard master character (*)• If you don't code the lac 
parameter* UPDATE uses the vaiye of profile variable 
updtncc* and if there's no such orbfile variable* uses the 
default master character asterisk t*). 
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Example of UPDATE Usage 

ses«iipdate f nofiday^ tuesday^fri day)^ piscobolpl 

* APPLYING MONDAY.. FRIDAY TO C08QLPL 

* NEW LIBRARY ON SESTMPL 

* NEW LIBRARY NOW ON CQBOLPL 

* SESTHPL PURGED 

REVERT. END UPDATE COBOLPL 

This example shows a list of modifications In files nondayf 
thyrsday and frlday applied against the cobolpt orbgraw library. 
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20.0 lIiyaySi3-£EII££SS-IQ0il.l 



KM-r-lQ£mE£.j:Qi£yi£E.MQ£l]i-.fi£liSM 

The stryctured process tools are a set of Design Dictionary 
utliities^y Computer Graphics Design tools and CYBIl to Strycture 
Chart tools. They support the Structured 4fial ysl sfS tructur ed Design 
CSASD) methodology used for development of softviare. 

SCADG creates or updates DFO* SCT an:! DSD diagrams used in the 
SASO methodology. 

SCADGEOIT a utility that enables a user to edjlt*: copy* reorder* 
nierge and list title information for diagrams in 
notebooks created by SCADG. SCADGEOIT does not required 
a graphics terininal. 

DOCREATE creates a design dictionary. 

DDDISPLAY displays the contents of a deslgi dictionary. 

ODHERGE merges two design dictionaries Into a new* third design 
diet ionary. 

DOXREF prepares a cross reference listing of a design 
diet ionary* 

DDXCHK checks a design dictionary for canslstency. 

DDHREF produces hierarchical expansion reports for selected 
entries in a design dictionary. 

DDEOIT provides for interactive editing of entries in a design 
dl ct ionary. 
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CYTOSCT creates graphics notebook files- of structure charts frofn 
CYBIl source code. 



CYTOOD is the first phase of CYTOSCT. CYfOOD creates a design 
dictionary for input into 0DT3SCT fsee note below on 
advanced design dictionary). 

OOTOSCT creates graphics notebook files af structure charts from 
design dictionary files produced by CYTOOD {see note 
below on advanced design dictionary).? 

FTNTOSCT creates graphics notebook files of structure charts frofp 
FORTRAN source code. 



FTNTODD is the first phase of FTNTOSCT. FTi^TOOD creates a design 
dictionary for Input into O'lTOSCT (see note below on 
advanced design dictionary). 
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The Coinputer Graphics Dlagr am tool supports the Data Flow Oiagram 
COFD)> Structure Charts (SCT) and Data Str?ictire Oiagram lOSDJ* 
These diagraiss can be created* printed* saved* recall ed and updated 
using a COC 721-30, IST-III or TEKTRO^K^ 4014 Sr'aphi cs Terminal. 
The COC 721-30 requires the 721-301 Gr aphlcs/fl rlnwar e option. See 
the "Appli cable Documents** section of this document for the ssanual 
that supports the SCAD Graphics. 

The Design Dictionary Utilities provide a set of creation, 
updating, checking and printing functioris. The Design Dictionary 
consists of CREATE, DISPLAY, MERGE, XCHEC^,: XREFt: HREF and EDIT 
functions. See the "Applicable Documents'* section of this document 
for the manual that supports the Design Dictionary. 

The CY8IL and FORTRAN to Structure Chart tools create graphics 
notebook files from CYBIL or FORTRAN source code* The process 
consists of two procedures, CYTOOO or FT^TODO and DDTOSCT. The 
procedures can be run separately or as a single procedure, CYTOSCT 
or FTNTOSCT Csee note below on advanced desi gn dl ct i onary ) . See the 
NOS GRAPH Graphics User's Handbook in the '•Applicable Documents" 
section of this document for the manual that suopopts the CYBIL and 
FORTRAN to Structure Chart tools. 

NOTE? The design dictionaries produced by the CY3IL and FORTRAN to 
Structure Chart tools are ^n advanced version of design 
dictionary* These advanced design dictionaries are Qfii 

compatible with the current design dictionary tools, DDCREATE, 
DOOISPLAY, etc. 
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The SCAD Graphics tool* SCADG* supairts the creation and 
maintenance of Data Elow Diagrams {DFOI* Data Structure Diagrams 
(OSDI and Structure Charts (SCT). These ilagr'ais are the primary 
diagrams used in the SASO technique. It Is assuflRei you are familiar 
»ith SCAD. Parameters to SCADG aret 



ntbk 



(optional) name of the Inttiaf fife to be used as the 
source notebook. If this paraietar Is not coded* SCA06 
uses the value of the profile variable ntbk. If the ntbk 
parameter is not defined in the user's profile* SCADG uses 
the filename N0TE8K. The ntbk r^otsbook Is copied to a 
working file* SESTMNB* if the ntbk and newntbk notebooks 
are the same filei otherwise* the >iorking notebook is the 
nenntbk notebook. If the ntbk file does not exist* SCADG 
creates a new notebook. 



neiintbk : 

(optional) naiae of the file to receive the updated ntbk 
notebook. If the neiintbk parameter is omitted or is the 
same as ntbk# the new or updated notebook Is copied back 
over the ntbk file. 



term 



the tent parameter specifies the user's terminal type. 
Valid terminal type entries are : 721, IST3 or TEK4014. If 
this parameter is not coded* SCA3G uses the value of the 
profile variable tern. If not defined in the user's 
profile* SCADG requests the terminal type. 



baud : 

represents the baud rate of your teminal. Acceptable 
values for each terminal type are as follows: 721 - 300* 
1200* 2400* 4800 or 9600. IST3 - 300* 1200 or 2400. 
TEK4014 - 300* 1200* 2400* 4800 or 9600. If this parameter 
is not coded* SCADG uses the value of the profile variable 
baud* If not defined In the user^'s profile* SCADG requests 
the baud rate. 



hardcopy : 

Indicates whether the terminal has a hardcopy device 
connected. This parameter may be cjiver^ values of 'YES** 
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«¥•> «N0« or *N«» If this parametsf is not coded* the 
value of the profile variable fiardoopv Is used. If not 
defined In the user's profile* S*AOG requests whether a 
hardcopy device Is present. 



egm 



sync 



refers to the Extended Graphics Utidule of the TEK4014. 
Acceptable values for the egm parameter are «YES«» •¥«> 
♦NO* or 'N'* The eg» parameter does not apply to IST3 or 
721 terntlnals. If this parameter Is not coded* SCAOG uses 
the value of the profile variable egm* If not defined in 
the user's profile* SCADG requests whether* EGM is present. 



refers to Synchronous or Asynchronous no6e for a TEK4014 
teri«ilnal« The sync parameter does not apply to IST3 or 721 
terminals. Acceptable values ^or' the sync parameter are 
•A« or 'S'. If this parameter Is not coded* SCADG uses the 
value of the profile variable syhc.i If not defined in the 
user's profile* SCADG requests *ihether the terminal is 
running In A or S mode. 
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Example of SCAD6 Usage 

SES.SCAOG NTBK«HYBOOK NEMNTBK«Hy*IEilBK 

ENTER TERHIHAL TYPE CIST3, 721 3R TEK%01%I 

? 721 

WHAT BAUD RATE C300» 1200f 2400f^800 OR 9600) 

t 9600 

WITH HARDCOPY* CYES OR NOI 

? Y 

* PREPARING SCADS - PHASE WAIT * 

* * 

BEGINNING SCAOG 2.1 UPDATING «YB!30<i •> HYNEtfBK 



OLD NOTEBOOK « MYBOOK NEW NOTEBOOK « MYNEMBK 

TYPE IN CONHANO 
? 

C SCADG interactive session I 

REVERT. END SCAOG, NOTEBOOK PROCESSING C3NPLETE 
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20.0 STRUCTURED PROCESS TOOLS 

20*2 SCAOGEDIT - DIA6RAH HEADER EDIT S LIST, !^0TE33OK UTIL. 

The SCADGEOIT SES procedure provides a jtitlty for editing and 
llstjna the diagram title blocks arid notebook maintenance. 
Paraffleters to SCAOGEDIT aret 



ntbk 



Coptionall name of the file contalt^ing the notebook. If 
this parameter is not coded* SCADSEDfT uses the filename 
N0TE8K. The ntbk notebook is cooled to a working file 
SESTMNB if the ntbk and newntbk notebooks are the saise 
file» otherwise the working notebook Is the neiintbk 
notebook* No changes are made to the ntbk notebook unless 
It is also the new notebook and than only after SCAOGEDIT 
terminates. 



nenntbk : 

(optional) naaae of the file to be used as the new notebook. 
If this parameter is not coded* disposition depends on the 
profile variable olde^neii* If there Is no such variable 
defined in the profile or olde<inejf has a value of FALSE* 
SCAOGEDIT writes the notebok to the fileNEWNTSK. If 
oideqneif has a value of TRUE* SCADSEDIT writes the notebook 
back to the ntbk notebook. 



I I 



dfile 



print 



(optional) name of the file to r*9ceive the listing output 
from SCAOGEDIT. If this parameter Is not coded* then 
SCAOGEDIT will use the fllenaaie LISTING for listing output. 



(optional) name of the file containing directives* in NOS 
64 character set format* for the SCADGEOIT processor. If 
this parameter is not coded* then SCADGEOIT accepts 
directives from the terminal or* lfi the case of a batch 
job* from the filename INPUT. T»ie dfllis file is irewound 
before It Is used. 



(optional) parameter to control the PRIMTIng of the output* 
I file. When the Job runs In batch mo^e and there is no I 
file* one copy is printed autonat i call v . If running the 
procedure in local mode* no copies? are printed unless the 
user specifically codes some print oarameter. For example* 
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you code prlnt«c»3 to obtain three cooles of the I file. 
The foriaat of the print par asieter* } s that of the parameters 
for the PRINT procedure. 
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The DOCREATE function takes a user text Input file and creates a 
Design Dictionary CDO) file* Paraffleters to OOCREAfE are s 



(optional) naiae of the file coitalnirig the source for 
creating the 0D« If you don't code the I paraineterf then 
ODCREATE uses the value of the profile variable ddi* and If 
there's no such variable defined In your profile* then 
DOCREATE uses the filename ODTEXt. The I file is rewound 
before It Is read. 



neH 3 



Coptlonal) name of the file onto i#hlch the new 00 is to be 
written. If you don't code the new parameter* then 
ODCREATE uses the value of the profile variable ddnew* and 
if there's no such variable defined In your profile* then 
DOCREATE uses the file name NEWDO.i 



Example of DDCREArE Usage 

SES.ODCREATE I»HYTEXT> NEW«lir^EWOO 
* BEGINNING DO CREATE 

( Additional informative less ages from ODCREATE ) 

» HYTEXT > MYNEWOO 

REVERT* END DO CREATE 



This example shows DOCREATE used to create a new design dictionary* 
HYNEWDO* from the text In the source file lYTEXT. 



20-10 
CDC - SOFTWARE ENSIMEERING SERVICES 

18 Oecember 84 
SES User's Handbook REVs 4A 

20.0 STRUCTURED PROCESS TOOLS 

20.4 ODDISPLAf - DISPLAY A DESIGN OICTIO^ARf 

The DOOISPLAY function extracts entries frbn a design dictionary 
and writes them to an output text file.! Extraction criteria are 
specified by directives on a directives file or by specifying a 
dlist parameter* Parameters to DOOISPLAY are ? 



old 



dfiie 



diist 



(optlonaH nasie of an old design dictionary file frofR which 
entries are to be extracted* If yau don't code this 
parameter^ then DOOISPLAY uses the vaiye of the profile 
variable ddoldf and If there's no such variable defined In 
your profile* then DOOISPLAY uses the filename QLOOD* 



(optional) name of the file to receive the output from 
DOOISPLAY* If you don't code this parameter* then 
DOOISPLAY uses the value of the profile variable ddo> and 
If there's no such variable defined In your' profile* then 
DOOISPLAY uses the filename ODTEXT.f The o file is not 
r ewound* 



(optional) name of the file containing directives* in NOS 
ASCII I Ine-lmage format* to the DOOISPLAY processor* If 
you don't code this parameter* DDDISPLAY uses the value of 
the profile variable dddflle* If there's no such profile 
variable defined In your profile and a dllst parameter Is 
not specified* then DOOISPLAY accepts directives from your 
terminal or* in the case of a batch Job* from the filename 
input* The dflle Is not rewound* If you code the dflle 
parameter* don't code a dllst paraneter* 



(optional) parameter specifies a DOOISPLAY directive or 
directive list* Acceptable values for dllst include: all* 
allh* data^ file* flow* coiaponent» element* process* 
processh* module* dfd* dfdh* s'ct^ notype* and undef* 
Directives of the form 'psn n* may also be Included In the 
dllst* Coding the dllst parafneter* Is equivalent to 

specifying directives on a dflle (directives) file* If you 
code the dllst parameter* don't code the dflle parameter* 
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(optional) name of a Sase Library to be updated* If you do 
not code the b or the m paramsterV display output is not 
Placed in a Base Library. If you c^de the w para?fleter> but 
not the b paraiiieter# the b par ameter def aul ts to 8ASE. 



ii 



ioptlonatl name of the Common Hodule to be created frow the 
display output* REPHOD replaces the « module on the b Base 
Library. If you code the b paraneter* and not the m 
parameter^ the m parajneter defaults fo DICT. 



print 



loptionai} parameter to control the PRINTIng of the outputs 
o file. When the job runs In batch «ode and there Is no o 
file* one copy is printed automatically. If you run the 
procedure in local mode* no copies are Printed unless you 
specifically code some print parameter. For example^ you 
code pr lfit«c«3 to obtain three cooles of the parameter o 
file. The format of the print paraneter Is that of the 
parameters for the PRINT procedure. 

Example of DDOISPLAf^ Usage 

SES*DOOISPLAY> OL0«HYOLO00# 0«LlSTITf DfILE»DQWHAT 

* BEGINNING DO OISPLAY 
ACCEPTING DISPLAY DIRECTIVES 

C Additional infof mat Jve nessa<ies frlim ODDISPLAY ) 

♦ NYOLDOO > LISTIT 

REVERT. END DO DISPLAY 

This example shoMs ODDISPLAY used to disal ay selected entries from 
the design dictionary* MYOLDDD. The directives for selecting 
entries nere read from the file DOWHAT. If the dflle parameter had 
been omitted* directives would have been read from the file INPUT. 
The listing of formatted design dictionary entries Has written to 
the file LISTIT in the order selected by the directives read from 
the file DOUHAT. 

The b and m parameters are useful for Including sections of the 
design dictionary as sections of an Analysis and Design 
Specifications document. 
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20.5 iil^M£gi£^z.ll£Sfi£^IMII.Ili51£i-fiIQIlQ!iiEIEl 

The DDMERGE function combines two desigri dictionaries to produce 
a new* third DD. Rarameters to DDMERGE are s 



old 



neM 



(optional) name of the old design dictionary file with 
which you wish to merge another des«lgn dictionary. If you 
don't code the old paraisetert then ODNERSf uses the value 
of the profile variable ddoldf and if there's no such 
variable defined in your profile* then ODMERGg uses the 
f i lename QLDDD. 



Copttonal) name of the fife onto ^hlch the t\em 00 is to be 
written. If you don't code the new uar'ameterf then ODMERGE 
uses the value of the profile variable ddneii* and if 
there's no such variable defined In your profile* then 
OOMERGE uses the file nasie NEWDO. 



merge : 

(optional) nawe of the design dlctlonarV file you wish to 
iserge with the old design dictionary. If you don't code 
the merge parameter* DDMERGE uses the v^lue of the profile 
variable ddaierge* and if there's no such variable defined 
in your profile^ then ODHERGE uses the filename HEROD. 

replace s 

(optional) iisx causes entries contained In the old design 
dictionary whose names are duplicated by entries contained 
in the merge design dictionary to be REPLACE'd by the merge 
design dictionary entries. A file named OOtOG will contain 
a list of duplicate entries and the action taken in each 
case. 



Example of DONERGE Usage 

S£S.DDMERGE# OLD»MYOiODD> HERGE«*IERG£OD# MEW«MYNEWOD* REPLACE 

♦ BEGINNING DO MERGE 

♦ MYOiOO ♦ NERGEOO > MYNEWOO 

REVERT. END 00 HERGE 



This example shows the use of DONERGE to cojubine entries from the 
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design dictionaries HYQiDOD and HERSEDD to for* a neM design 
dictionary HYHEWDO. If an entry name is defined i?i both HYOLODD and 
HERGEOD then the definition used in creating Hr*IE«DD is taken from 
NERGEDO. If the REPLACE parameter had besf> oinitted* the definition 
fro« ilYOLODO would have been used. In eltlier' case an explanatory 
record Is written to filename ODiOG. 
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20.6 MM££«=.£fiQlS-SI£I£IM£I«^-2iaiM-0iaillMI 

The DOXREF function produces a formatted cross reference Msting 
of part or all of a design dictionary. Parameters to ODXREF are s 



old 3 



ref 



Midth 



print 



(optional) name of the old (design dictionary file from 
**hich you want a cross reference listing.! If you don't 
code the old paraweter* then DDXREF uses the value of the 
profile variable ddold^ and if there's no such variable 
defined in your profile* then DOXREF uses the filename 
OLOOO. 



(optional) name of the file to receive the output of ODXREF 
In a form suitable for printing on the ASCII printer. If 
you don't code the I parameter* then ODXREF uses the value 
of the profile variable ddl. If there's no such variable 
defined In your profile* and you're running DOXREF LOCAL at 
your terfflinalf the output appears an a file called LISTING. 
The f file is not rewound. 



(optional) parameter selects the type of entries you want 
to be Included In the cross reference listing. Acceptable 
values for ref are: flOM* component* elieiient* file* data* 
process* module* dfd* set* notype* undef* and ail. 



(optional) parameter selects the page width of the output 
listing written to the I file. Acceptable values for width 
are printer or term (for terminal •♦Idth). If you don't 
code the width parameter* then DDXREF usest the value of the 
profile variable ddwidth* and If there's no such variable 
defined in your profile* your listing will be formatted for 
a line printer* 



(optional) parameter to control the PRIHTIng of the output* 
I file* When the job runs In batch mode and there Is no i 
file* one copy is printed automatically. If you run the 
procedure in local mode* no copies are printed unless you 
specifically code some print parameter. For example* you 
code print«c«3 to obtain three copies of the parameter I 
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fife. The format of the print parameter Is that of the 
parameters for the PRINT procedure. < 

Example of DOXREF Usage 

SES.OOXREFf QLO-HYOLDDDf fllSTITf REf*ALi> W10TH«TER« 

* BEGINNIN6 DD XREF 

CAdditlonal inforniatlv^ messages fr^ii DDXI^EF) 

♦ MYQIDDD ~-> LISTIT 
REVERT. END OD XREF 

This example shOMS the use of DDXREF to obtalr^ a terminal width 
cross reference listing of all sections of the design dictionary 
HYOIDOD. The cross reference listing will be on the local file 
LISTIT. Printed copies could have been obtained by adding a PRINT 
parameter. For example^ PRINT*IC*3fH«*XLIST«) would have caused 3 
copies with a header XUST to be printed. 
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20 . 7 ei2X£aii-=.Cai£E-A«a£aiSH.ai£IlQMiSI«£0i:-k2MEllIE M£I 

The DOXCHK function runs a cross check against a design 
dictionary. A formatted listing is orbduced siNlch contains the 
names of entries iihich weet criteria selected by the check 
parameter. Parameters to DDXCHK are 5 



old 



check 



print 



(optional) naiae of the design dictionary file you want 
cross checked. If you don't code the old paraneter* then 
DDXCHK uses the value of the profile variable ddoldf and if 
there's no such variable defined In your' profile^ then 
DDXCHK uses the filename OlDOO. 



Copt lone 1) name of the file to receive the output of DDXCHK 
in a form suitable for printing on the ASCII printer. If 
you don't code the I parameter^ then 90XCHK uses the value 
of the profile variable ddf. If there's no such variable 
defined In your profile* and you're running DDXCHK local at 
your terminalf the output appears on a file called LISTING. 
The I file Is not rewound* 



Copttonal) parameter specifies the kind of consistency 
check you want run against the old design dictionary. 
Acceptable values for check ar'es undef» unref* noref# 
recur* and ful 1. 



(optional) parameter to control the PRIMTIng of the output* 
I file. When the Job runs in batch mode and there is no i 
file* one copy Is printed automatically. If you run the 
DDXCHK procedure in local mode* no copies are printed 
unless you specifically code soine print parameter* For 
example* you code prlnt«c»2 to obtain t«o copies of the 
parameter I file. The format of the print parameter is 
that of the parameters for the PRIMT procedure. 
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Example of DDXCHK Usage 



SE$.OOXCHK# OtO«HYOLODD# L«iISTITV CHECK«f Uil 

* dEGINNING OD XCHECK 

I Additional infofiiatiye messages from DDXCHK > 

♦ MYOLDDO > LISTIT 

REVERT. END OD XCHECK 



This exaiipie shovis the use of DDXCHK to p9r'for?« a full cross check 
of the design dictionary HYOtDDD. The cr*<5ss check listing wilf be 
on the local file LISTIT. Printed copies cjuld have been obtained 
by adding a PRINT parameter. 
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The DOHREF procedure produces yierarcHlcaf gllE^erence expansion 
reports for selected entries in a desi gn di cti oniry. 



old : 



i s 



^optional) naaie of the design ilctlonarV file from which 
you want hierarchical reference expansions. If you don't 
code the old parai^eter* then DO^^EF uses the value of the 
profile variable ddold# and if there's no such variable 
defined in your profile* then DOHRPF assumes the design 
dictionary Is on a file called 0LDD9* 



(optional) naiae of the file to receive the output of DDHREF 
in a form suitable for printing an the ASCII printer. If 
you don't code the i parameter* then DDHREF uses the value 
of the profile variable ddl. If there Is no such variable 
defined in your profile* then OOHREF output appears on a 
file called LISTING. The I file Is not rewound. 



dfile t 

(optional) naiae of file containing directives to OOHREF In 
NOS ASCII llne-laiage format. 



enter/noenter • 

(optional) t&X controlling selection of interactive 

directive input to OOHREF. Enter selects Interactive 
directive Input via your terminal keyboard. The default is 

noenter (I.e.* no terminal Interaction).' If a dfile was 

specified* interaction would occur after DDHREF reads the 
dfile. 



levels * 

(optional) roaxirouiB number of hierarchical levels to which 
DDHREF will expand design dictionary entries. If 

specified* the value must be an Integer from 1 to 10; the 
default value is 5. 



droots/nodroots i 

(optional) iifi^ control I ing selection of the DDHREF derived 
roots entry name expansions. Specifying droots causes 
these entry names to be expanded at the end of your OOHREF 
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print 



session* Specifying nodroots causes ODHREf to only expand 

the user supplied entries in tlia syppMed root list* The 

default value is nodroots If the enter key is specified^ 
otherwise the default value is dr%ots*^ 



(optional) parameter to control^ the printing of the I 
(output) file* When this job runs In batch raode and there 
is no i file* one copy is printed lutonatical I y* If you 
run the OOHREF procedure In local mode* no copies are 
printed unless you specifically code some print paraineter* 
For exanipiet you code pr1nt*c*2 to ohtain t**o copies of the 
paraaieter I file* The format of the print parameter is 
that of the parameters for the PRINT orbcedure* 
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20.9 ailiiliI^r.£0iI«4.a£iI£M-llKIIQiMI 

ODEOIT alioHS you to Interactively exaiine and alter the contents 
of a design dictionary on an entry-by-aitry basi s via directives 
that you enter frow your terminal* Paraiseter's to DOEOIT are s 



old 



neM 



scr i 



(optional) name of an existing desi gn dl ct I onary that you 
want to edit. If you don't code this oaraweter and also 
don't specify the create key ^described below)# then ODEOIT 
uses the value of the profile variable ddoldf and If 
there's no such variable defined I n your ^rbf 1 1 e* then the 
filename OLOOO is used. 



{optional) na»e of the file onto s^hlch the new edited 00 Is 
to be written. If you don't code the new parafflieter# then 
DOEDIT uses the value of the profile variable ddnew# and if 
there's no such variable defined In your profile* then the 
filenasie NEWDD Is used. 



Coptional) name of the file that contains or will contain 
entries you wish to add or r'solace In your design 
dictionary. If you don«t code the scr parameter* then 
DOEOIT uses the value of the profile variable ddscff and If 
there's no such variable defined in y^ur profile* then the 
filename SCRATCH Is used. 



(optional) name of the text editor you want to use to edit 
entries on the scr file. Acceptable values for e are 
XEDIT* EDIT* EOT or FSE« If you don't code this parameter* 
ODEOIT uses the value of the profile variable dde* and If 
there's no such variable defined in your profile* you'll 
get XEDIT as your editor. 

create s 

(optional) Isax when specified indicates to DOEOIT that you 
want to begin a new DO. If you code the create iifii* you 
can't code the old parameter. 
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Example of DOEDIT Usage 

SES. OOEOIT# 0L0«HfOLDDD# NEM«MYN€»IODf SCR««YSCR> £«FSE 
* BEGINNING DO EDIT 

ENTER DOEDIT DIRECTIVE. 

CAdditlonal OOEOIT/User Interact Ion) 

REVERT. END QQ EDIT 



This example shows OOEOIT being used to edit an existing design 
dictionary* HYQLDOD. During the DOEDIT session* text editor FSE is 
used to edit 00 entries contained on the file ?1fSCR* When the 
OOEOIT session is terfliinated* the edited 53 Is to be written to file 
HYNEWDO. 
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20.10 £XIQaiII.=.£IIIL.Ii3-SIEy £IUB£- illiillS 

Ttie CYBIl to Structure Chart tool* CYTOSCT* creates an SCAD 
graphics notebook frofn CY8II source code. CYTOSCT performs the 
corsbined functions of the CYTODD and DUTISCT tools. Input to 
CYTOSCT Is syntax error free CYSIt source code. The CYTQSCT tool 
creates? 

1) a graphics notebook. 

2) a table of contents listing and a^ index listing of the 
graphics notebook. 

3) a cross reference listing of the design dictionary (if 
sel ected) . 

(See note on advanced design dictionary at the beginning of 
thi s section. ) 

Parameters to CYTQSCT are s 



input or i : 

{optionall name of the file containing error free CYBIL 
source code. If you don't code the I parameter^ CYTOSCT 
uses the value of the profile variable cdl. If there is no 
such variable defined In your profiiief CYTOSCT assumes the 
CYBIL source is contained on a file naned COHPILE. 



ntbk 



nlist 



(optional) name of the file onto which the new notebook is 
to be written. If you don't ode the ntbk parameter* 
CYTOSCT uses the value of the pr'bflle variable ntbk. If 
there Is no such variable defined i n your prof 1 1 e* CYTOSCT 
uses the filename NOTEBK. 



(optional) name of the file onto which the table of 
contents and Index listings for t^e notebook are to be 
written. If you don't code the nllst paraflieter* CYTOSCT 
uses the value of the profile variablie ntist. If there is 
no such variable defined In your profile* CYTQSCT uses the 
f I lename NLIST. 



order J 

(optional) parameter to control the order of the structure 
charts that are generated. If the order 9arameter is coded 
as A> the structure charts are produced in alphabetical 
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order* If the order parataeter is codec! as H^ the structure 
charts are produced in hierarchical or'der. The default 
value for the order parameter Is 4. 



newdd 



xref 



print 



un 



(optlonall name of the file onto i^hlch the new design 
dictionary is to be written. If you doil»-t code the newdd 
paraaieter» CYTOSCT uses the valua of the profile variable 
ddneM* If there Is no such variable defined in your 
profile* CYTOSCT uses the filename DDNEW. 



Coptional) name of the file onto »*hlch a cross reference 
listing of the new design dictionary Is to be written. If 
you don«t code the xref paraiaeter* CYTOSCT uses the value 
of the profile variable ddxref.s If there is no such 
variable defined in your profile* no cross reference 



listing Is generated. 



{optionall parameter to control printing of the nllst and 
xref files. If you code the print keyword* one copy of 
each of the files Is printed. You code pr1nt«c*2 to obtain 
two copies of each file. The foriat of the print parameter 
is that of parameters for the SES.PRIMT procedure. 



(optional) user name associated with files used by CYTOSCT. 
If you don't code the un parameterV CYTOSCT uses the value 
of the profile variable cyun. If there Is no such variable 
defined in your profile* CYTOSCT assumes the files are in 
the current user's catalog. Notes If un Is not the current 
user's catalog* the ntbk and newdd flies inust exist with 
write permission. In local roode CYTOSCT allows the use of 
local files for nllst and xref fil*es* but In batch mode 
these files m\ist exist with write oermlsslon. 
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Example of CYTOSCTllsage 

SES.CYTOSCT I«COMPIt£ N£IIOO«OOFIlfMT8!(*H3FItE •• 
HIIST«HTBKLST 

♦ BEGINNING CYTQSCT VI ON CO^Pfll -> DDfllEt N8FIIE 

♦ BEGINNING CYTOOO V 1 ON COMPILE -> ODFflE 



♦ END CYTOO0 CONPIiE -™> OOFfLE 

* BEGINNING OOTOSCT VI ON ODFfLE— > N8FILE 



♦ CREATING UNFORNATTEO N0TE8Q3< 

♦ CONSOLIDATING NOTEBOOK 

♦ FORHATTING NOTEBOOK 

♦ END CYTQSCT COMPILE -> NBFILlf NTBKLST 
REVERT. 



This example shows CYTQSCT creating a i«» 00 fifCf DDFILE# and a 
ne*i graphics notebook* NBFILE» from the CTBIL source code found on 
file COMPILE* The table of contents and index listings of the 
notebook are on the permanent file NTBKLST.i 
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20.11 £II0aS-=^£IMi«I0-.i2£ai£M.SllIIiQMiSI 

The CYSIi to Design Dictionary tool* CYflDO* Is the first phase 
of the CYBIL to Structure Chart tool* CTTOSCT. The CYTODD tool 
creates a design dictionary that is input to the DDTOSCT tool tsee 
note on advanced design dictionary at the beginning of this 
section). Parameters to CYTOOO are t 



input or I : 

(optional) nawe of the co!»plle file containing error free 
CYBIL source code. If you don»t code the I parameter ^ 
CYTOOD uses the value of the profile variable cdl. If 
there is no such variable defined In your profile* CYTODD 
uses the fllenaite COMPILE. 



neMdd t 

(optional) naipe of the file onto which the new 00 is to be 
written. If you don't code the nevidd parameter* CYTOOD 
uses the value of the profile variable ddieit* If there is 
no such variable defined in your* prof lie* CYTOOO uses the 
f i lename OOHEW* 



xref 



print 



un 



(optional) name of the file onto >ihich a cross reference 
listing of the new design dictionary Is to be written. If 
you don't code the xref parameter* CYT10D uses the value of 
the profile variable ddxref« If there Is no such variable 
defined in your profile* no cross reference listing is 
generated. 



(optional) parameter to control printing of the xref file. 
If you code the print keyword* one cooy of the file is 
printed. You code prlnt«c«2 to obtain two copies of the 
xref file. The format of the print oar'ameter Is that of 
the parameters for the SES .PRINT procedure. 



(optional) user name associated with flies used by CYTOOO. 
If you don't code the un parameter* CYT0D5 uses the value 
of the profile variable cyun* If there Is no such variable 
defined In your profile* CYTODD assumes files are In the 
current user's catalog. Notes If un Is not the current 
user's catalog* the newdd file nust exist with write 
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permission. In local laode CYTQOD aflons the use of a local 
file for xref> but in batch wode xr*ef^ust exist «ith write 
perffliisslon. 



Example of CYTODD Usa^e 



SES. CYTODO I«COMPILE NEtfDO«DDFIlE 

♦ BEGINNING CYTODO V 1 ON CO^PTLlE -> OOFILE 

* CYBIL COHPILING COMPILE 

♦ BEGINNING CREATION OF DOFILI 

* PROCESSING TEXT FOR NODULE 1001 

♦ PROCESSING TEXT FOR NODULE 1002 

* END CYTOOD COMPILE -> DOFf LE 

REVERT. 



This example shows CYTODD compiling source cofle found on file 
COMPILE and creating a design dictionary or* file ODFILE. 
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20.12 fiflIQSa.r-l}£SI2M«iU£II0lii^EX-IQ«SI£ywIUEl-i:>!lEIl 

Tfie Design Dictionary to Structure Cfiart tool* DOTOSCT* is the 
second and last phase of the Source Code to Structure Chart toolS:» 
CYTOSCT and FTNTOSCT. The OOTOSCT tool creates an SCAD graphics 
notebook froni a design dictionary created by CYTOOD Csee note on 
advanced design dictionary at the beginning of this section). 
Parameters to OOTOSCT are s 

oflddd t- 

{optionaU name of the file containing the design 
dictionary created by CYTOOO. If you don't code the otddd 
paraweterf OOTOSCT uses the vaitie of the profile variable 
ddoid* If there Is no such variable defined In your 
profile* OOTOSCT uses the fllenaii^e OlODO. 



ntbk 



niist 



order 



print 



(optional) name of the file onto which the new notebook is 
to be written. If you don't code the ntbk paradieter* 
OOTOSCT uses the value of the profile variable ntbk. If 
there is no such variable defined in your profile* OOTOSCT 
uses the filename NOTEBK. 



(optional) name of the file onto which the table of 
contents and the index information for* the notebook is to 
be written. If you don't code the nllst aarameter* OOTOSCT 
uses the value of the profile variable nlist* If there is 
no such variable defined in your profile* OOTOSCT uses the 
f i lename NLIST. 



(optional) parameter to control the order of the structure 
charts that are generated. If the order parameter is coded 
as A# the structure charts are produced in alphabetical 
order. If the order parameter is coded as H* the structure 
charts are produced in hierarchical order. The default 
value for the order parameter is A. 



(optional) parameter to control the printing of the nllst 
file. If you code the print key^ior'd* one copy of the file 
is printed. You code prlnt«c«2 to obtain two copies of the 
nlist f I le. The format of the print parameter is that of 
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parafieters for the SES.RRIHT procatfure* 



un i 



(optiofiall user name associated with files used by DOTOSCT. 
If you don*t code the un parameter* DOTOSCT uses the value 
of the profile variable ddun* If there Is ?to such variable 
defined In your profile* 00T3SCT assumes that the olddd 
parameter fi le is In the current user's catalog* Notei If 
un Is not the current user's catalog* the ntbk file must 
exist with write permission* In focal fuode DDTOSCT allows 
use of a local file for nlist* but I n batch mode nllst liust 
exist with write permission* 



Exampie of DDTOSCTllsage 



SES. DDTOSCT OLODO-ODFIIE NTBK-NBFIIE 

* BEGINNING DDTOSCT V 1 ON 00F5LE -> ^JSFILE 

* CREATING UNFORMATTED NOTEBOOK 

* CONSOLIDATING NOTEBOOK 

* FORMATTING NOTEBOOK 

* END DDTOSCT DDFILE -> NBFILE»I«LI$T 
REVERT. 



This example shows ODTOSCT creatinci a fiew graphics notebook* 
NBFILE* froffi the file DDFILE. The notebook's table of contents and 
index listings are written to file NLIST. 
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The FORTRAN to Structure Chart tool* FT^flSCT> creates an SCAD 
graphics notebooi? froiri FORTRAN 5 source code. FTNTOSCT performs the 
combined functions of the FTHTOOO and DDTDSCT tools. Input to 
FTNOSCT Is syntax error free FORTRAN 5 source code. Other versions 
of FORTRAN source code or FORTRAN 5 source co<fe containing errors 
may be input to FTNTOSCT* but sonae code nay not be recognized and 
Hill be bypassed. The CYTOSCT tool creates: 

1) a graphics notebook. 

2) a table of contents listing and a'^ Index listing of the 
graphics notebook* 

31 a list file of the source code vilth line nua^bers. Any 
source code diagnostics will appear* at the end of the list 
f i I e. 

4) a cross reference listing of the design dictionary lif 
selected! . 

(See note on advanced design dictionary at the beginning of 
thl s sect ion. ) 

Parameters to FTNTOSCT are s 



input or I « 

(optional} name of the file containing FORTRAN source code. 
If you don't code the i parameter* PTNTOSCT uses the value 
of the profile variable ftndl.l If there is no such 
variable defined in your profile* FTMT35CT assumes the 
FORTRAN source is contained on a file named COHPILE. 



ntbk 



niist 



(optional) name of the file onta ^hlch the new notebook is 
to be written. If you don't cide the ntbk parameter* 
FTNTOSCT uses the value of the profile variable ntbk. If 
there is no such variable defined In your profile* FTNTOSCT 
uses the filename N0TE8K. 



(optional) name of the file anto which the table of 
contents and index listings for the notebook are to be 
written. If you don't code the nl I st par ameter* FTNTOSCT 
uses the value of the profile varl ab I e nil st. If there Is 
no such variable defined In your or of He* FTNTOSCT uses the 
f i lename NLIST. 
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order 



Coptiotial) paraiBeter to control the order of the structure 
charts that are generated. If the order parameter Is coded 
as A* the structure charts are produced in alphabetical 
order. If the order parameter is coded as H> the structure 
charts are produced in hierarchical order* The default 
value for the order parameter is A.? 



mode or ii : 

(optionall pararater to indicate the node of the source 
input. If the mode parameter Is f^onseq* all the source is 
considered to be written in nonseciusnced mode. The mode 
parameter can also be seq which Indicates that the source 
line Is preceded by a sequence nu^Rher* The default value 
for the mode parameter is nonseq. 



neiidd 



(optional) name of the file onto which the new design 
dictionary is to be written* If you don* t code the newdd 
parameter* FTNTOSCT uses the value of the profile variable 
ddnew* If there is no such variable defined in your 
profile* FTNTOSCT uses the filenaie DD^EW. 



1 1 s t o r I ? 

Coptlonal} name of a file onto which the source and any 
error messages will be fisted* If you cfon»t code the list 
parameter* FTNTOSCT uses the filer^ame LISTING. 



xref 



print 



(optional) name of the file onto s^hlch a cross reference 
listing of the new design dictionary is to be written. If 
you don^t code the xref parameter* FTNfQSCT uses the value 
of the profile variable ddxref*! If there is no such 
variable defined in your profllet no cross reference 
listing Is generated. 



(optional) parameter to control printing of the niist* 
list* and xref files. If you code the print keyword* one 
copy of each of the files is printed. You code prlnt«c«2 
to obtain two copies of each file.' The farmat of the print 
parameter is that of the parameters for the SES.PRINT 
procedure* 
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un 



Coptional) user nawe associated writN files used by 
FTNTOSCT. If you don't code the ufi parameter* FTNTOSCT 
uses the value of the profile variable ftntin. If there Is 
no such variable defined In your* prof I fe* FTNTOSCT assumes 
the files are In the current user^s catalog. Note? If un 
IS not the current user's catalog* tf^e net«dd and ntbic files 
aiust exist with write permission. In fbcal mode FTNTOSCT 
alioMS the use of local f i les» f orflst# nllst and xref 
files but In batch mode these files must exist with write 
permissi on. 



Exaiipfe of FTNTOSCT Usage 



SES.FTNTOSCT I-COMPILE NEWOD«0OFfLE NTBK«H8FItE .. 
NLIST-NTBKLST 

♦ BEGINNING FTNTOSCT V 1 ON COMPILE -> OBFILE, N8FILE 

* BEGINNING FTNTODO V 1 ON COHPfiE -» SOFIiE 



♦ END FTNTODO COMPILE— — > D9F€LE> LISTING 

♦ BEGINNING FTNTOSCT V 1 ON DOFILE -> ^BFILE 



♦ CREATING UNFORMATTED NOTEBOOK 

♦ CONSOLIDATING NOTEBOOK 

♦ FORMATTING NOTEBOOK 

♦ END FTNTOSCT COMPILE -> NBFILl^ MTBKLST 
REVERT. 

This example shows FTNTOSCT creating a 'lew OD f 1 1 e* OOFILE» and a 
new graphics notebook* NBFILE^ from the F3RTRAM source code found on 
COMPILE file. The table of contents and Index listings of the 
notebook are on the permanent file NTBKLST. A listing of the 
FORTRAN source and any error messages are on the file LISTING. 
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Ttie FORTRAN to Design Dictionary toolt FT^ITOOD* Is the first 
phase of the FORTRAN to Structure Chart tool* FTNTOSCT. The FTNTQOO 
tool creates a design dictionary that Is litmt to the DDTOSCT tool 
<see note on advanced design dictionary at the beginning of this 
section). Parameters to FTNTODD ar e s 



Input or I 1 

(optional} name of the coinpile file car^taining FORTRAN 
source code. If you don't cocf« the t parameterf FTNTODD 
uses the value of the profile varl ab f e f tnd i • If there is 
no such variable defined in your profile* FTNTODD uses the 
f i f enarae COHPIIE. 



neiidd 



{optional) name of the file onto >#hlch the new DD is to be 
written. If you don't code the newdd parameter* FTNTODD 
uses the value of the profile variable ddnew. If there is 
no such variable defined in your* or'of I I e* FTNTODD uses the 
f i lenawe DDNEW. 



mode or ID 3 

(optional) parameter to Indicate the lode of the source 
input. If the mode parameter Is nonse<99 all the source Is 
considered to be written in nonsaquenced mode. The mode 
parameter can also be seq which Indicates that the source 
line is preceded by a sequence nunber. The default value 
for the mode parameter is nonseq. 



list or I 5 

(optional) name of a file onto which the source and any 
error messages will be listed. If you don't code the list 
parameter* FTNTODD uses the fiienane LISTING. 



xref 



(optional) name of the file onto which a cross reference 
listing of the new design dictionarV Is to be written. If 
you don't code the xref parameter* FTNT30D uses the value 
of the profile variable ddxref. If there is no such 
variable defined in your profile and you don't code the 
xref parameter* no cross reference listing Is generated. 
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print 



un 



{optional) paratiietef to control prlntMg of the list and 
xref parasaeter files* If yon code the print keynord* one 
copy of the file Is printed. You code prlnt«c«2 to obtain 
two copies of each file. The format of the print parameter 
is that of the paraiiieters for the SES.PRIMT procedure. 



(optional) user naiae associated with files used by FTNTOOD. 
If you don't code the un paraiseter* FTNTOOD uses the value 
of the profile variable ftnun. If there Is no such 
variable defined in your profile^ FTNTIOD assumes files are 
In the current user's catalog. Note? If yn Is not the 
current user's catalog the neiidd fife fsust exist with write 
permission. In local mode FTNTODf) allows the use of local 
files for list and xreff but in batch tuode these files wust 
exist with write permission. 



Example of FTNTOOD Usage 



SES. FTNTOOD I«COHPILE MEWOD-ODFIll 

* BEGINNING FTNTOOD V 1 ON CO«<PfLE— > DDFILE 

* GENERATING 00 TEXT FROM COI^ILE 

* CREATING 00 ODFILE FROM 00 TEXT 

* END FTNTOOD COMPILE > OOFfLEt LISTING 

REVERT. 



This example shows FTNTOOD using source code found on COMPILE to 
create a design dictionary on file ODFILE. A fisting of the FORTRAN 
source and any error messages are on the fllte LISTING. 
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A PROFILE is an lfPportant» albeit optlonalf component of SES 
usage* Any user may choose to establish a PROFILE In their catalog 
or procedure library. PROFILE follows the same rules as any SES 
procedure* that is^ the name of the fife nust be PROFILE^ and the 
first line ot the profile must be the word ?>R(3FILE. From there on* 
the profile may contain just about any SES cjommand* The most 
important aspect of the profile is the SEARCH directlye* explained 
In the next section. 

Typically* the types of things that a user may place in the 
prof i ie i#ouid be i 

a command to set a variable called !>ASSyOR to the user's 
password* Procedures which optionally run as batch jobs can 
then get the user's password without having to be told It on 
the SES control statement* 

commands to establish defaults for library names (for the 
source code and library maintenance orocedures)* tape numbers 
<and related information for the tape management procedure)* 
and other data for various procedures* 

SEARCH directives to establish a search order* for procedures* 

It is possible for a user to have more than one PROFILE* and 
select which one to use by coding the PN or' P oaraneter on the SES 
control statement* For example* by coding 5 

ses*pn«af ternate^prof i le«procedur e^name I Ist^of .par aneters 

a user can use the file ••al ternate.prof i f e" as tfie PROFILE for the 
duration of that procedure call* Also* a user may use <omeone 
else's profile by coding the PUN or PU parameter* For example* by 
codi ng : 

ses*pun«prof i le.owner.procedure.name 11 st.!of. parameters 

a user can access the profile belonging to *'pr of i I e.owner"* Of 
course* the PN and PUN parameters may be used together* 
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Al.O. I SEARCH DIRECTIVE - ESTABLISH LIBRARf SEARCH ORDER 

Using the SEARCH directive* a user can astabllslif within PROFILE* 

the naaes of libraries to search when locating a prbceduref and aiso 

the user names in whose catalogs those procedure libraries reside. 
The general form of SEARCH is s 

\ SEARCH search_spec» search.spec.l»l..«i.t. 

^h^T e "sear ch^spec** is in the form s 

user^nane 

or 

C II brary.nawe* I ibrary_fiame....k^ user.Bamel 



The first form indicates that the library name contained In the 



of 
of 



predefined variable SESLNAH Is to be searched for in the catalog 
the user specified by ••user.nawe"* The second for% gives a list 
library nasaes* with the last item in the list being the user name in 
whose catalog those libraries may be found. ^ 



Exanples of SEARCH Directives 



\ SEARCH USER» SSSf SES 



\ SEARCH {SESLNAN* CC6}» USER* SSSt SES 



The first example shows a simple SEA^:::h directive. The search 
order for procedures Is first* the currently logged in user's 
catalog* then the SSS catalog* then the SES catalog. The second 
example searches first in the library giveT by SESLl^AM in the CC6 
catalog* then in the currently logged In user*«s catalog* then in the 
SSS catalog* and finally In the SES catalog. 



£Jil« Second and subsequent SEARCH directives are iSEliLfi^* 
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A 1*1 LOaiiliS-A-£EO££MS£ 



The SES processor performs its search for a given procedure 
according to weil defined and consistent rules. Basically SES has 
three methods of specifying how a procedure is to be located. The 
SES processor has an internal table which contains the following 
data t 



I ibrary.name 
i Ibrary^naiRe 
etc* 

etc* 
etc* 



yser.haiie 
user.naiwe 



Given that the table ?nay be set 



UP by one of three different 
methods which are explained in more detail in 
foHowingy the |»rocedyre that SES follows to locate 



a 



the sections 
procedure is t 



1. If there's a local file 
line is "procedur e.naine"^ 



of the *»pr3cedur e^name"* 
that file Is used asthe 



whose first 
procedure* 



2* SES searches the catalog of the ussr whose user name appears 
as the first entry in the table* for a file of name 
"procedur e.name"* whose first line Is ♦•procedur e^name"* If 
such a file is foundt it is used as the procedure* 

3* For each entry in the table* a search Is nade for a library of 
name "I i br ary.name" in the catalooi of the corresponding 
••user^name*** and searches that library (which fflUJSt have a 
directory) for a TEXT record of naiie ^•procedur e^name»»* If 
such a record is found* it is used as the procedure* 

4* If the search is unsuccessful* an error message is issued 

-PROCEDURE procedur e.name 13T FOUMO- 



The next three sections provide a more detailed explanation of 
the methods by which the SES processor has its search table set up* 
The methods are basically the default* the user name specified on 
the SES control statement* and the SEARCH directive* 
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AlU.l DEFAULT ORDER OF SEARCH 



yhen the SES processor is called^ it sets ut> the foH owing data 
n its search table t 

4. «-...« — • >-«.«« — ^™ «-+ 

; £SESLNAH£; ; yser.nave ', 

I 4 « 

« * « 

I CSESLNAHS t SSESUI^AIS 1 

^ — 4. ^ ^ — -^ — 4. 



This table Is the normal default for' SES.i '•user.name*' Is the 
user nanse of the current user* 

"SESLNAil** Is a predefined variable which cor»talf^s the name of the 
SES Library NANe* "SESUNAM" Is a predefined variable which contains 
the SES User NAMe* 



Al.1.2 SEARCH SPECIFIED ON CONTROL STATEHE1T 



When the user types the SES control statement* he may specify via 
the UN or U parameter of the SES progrant which user's catalog to 
look in for the procedure specified by the call. For example i 

ses#un«user_name«procedure.naffie f f st^of ^parameter s 

specifies that the procedure "procedure.nane" is to be searched for 
fldil in the catalog of the user "user^name" (If the procedure Is not 
already local). In this case the SES processor modi fi es its search 
table to contain only the following data s 

+ + + 

I CSESLNANS \ user.nane ? 

4. — « — — + . «■- — > 



where "SESLNAM** contains the SES Library NiAMe as before* and 
••user.narae" Is the user naaie specified on the SES control statement. 
It is also possible to tell the SES processor* via the LIBPFN or 
LPFN parameter* the name of the library to be searched for the 
procedure* For example i 
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Al.O PROFILES 

Al.1.2 SEARCH SPECIFIED ON CONTROL STATEMEIf 

sesf lpffi»lib_r)aAe«proeedur8.na«e 11 st.of _par ameters 

specifies that the procedure "procedure^nane'* is ta be searched for 
SLUl^ in the ribrary '•lib.naflie** In this case the SES processor 
modifies its search table to reflect the follbviing data 5 

^-^. — . ^^ ^ 4. 

! I lb^na»e * user^nains I 



where •"user^naroe" is the user name of the current user^ and 
•*i i byname** Is the library name specified on the SES control 
statewent* Of course^ the UN and LIBPFN oara^eters may be used 
together* 



Al.l*3 SEARCH ORDER SPECIFIED VIA SEARCH DIRECTI\rES 



The third method of specifying the order' In which to look for the 
procedure Is via SEARCH directives in the user's PROFILE. For 
examplef supposing that the user's PROFILE contains the following 
SEARCH directive : 

\ SEARCH CH0LMLIB#JIMLIB#H674)f AMT4» JF03» C AI^OYLIBf ED73I 



in this case the SES processor would jaodify Its search table to look 
like this : 



HOLMLIB ! H674 

JIHLIB i H674 

SSESLNAMS I Af174 

ESESLNAN& *. JF03 

ANDYLIB ! E073 



..-^. 



Hats • SEARCH directives are ignored If the UN or LIBPFN 
parameters were specified on the SES control statement* 
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8 1 • Q£§£iIlMiz«aaO£S-Q£.IU£«i£S-£Ea££iiCIE 



The SES processor processes procedures 1?^ ofie of four modes s 

RUN Tbis Is the normal mode. The orbcedure is processed* 

presumably generating control state?«ents»" and then these 
control statej^ents are executed. 

TEST In this mode the procedure is processed in the noriaal manner* 
hilt the generated control stateuer^ts are not executed* 
Instead they are placed on a designated file for possible 
Inspection by the user* This ^ode is neant as an aid in 
debugging new procedures, 

HELP This «ode is similar to test uode» however instead of 
generating control statements* a procedure set up for HELP 
mode produces some documentation or^ Its purpose and usage* 

STATUS This mode is similar to test mole* ho^fever instead of 
generating control statements* a precedure set up for STATUS 
mode produces any change i nformati if* available about the 
procedure. 

The modes are selectable by the user by neans of parameters to 
the SES processor; and the procedure can determine In which of the 
modes It was called by means of predefined var'la'iles set up by the 
SES program. These variables are i 



MODE 



PRIMOUT 



This variable may be compared with the variables RUN* 
TEST* HELP or STATUS to determine which of the modes is In 
effect; for example : 

\ IF HOOE « HELP THEN 

•• code for HELP mode •• 
\ ORIF MODE - STATUS THEN 

" code for STATUS mode •• 
\ ORIF MODE « TEST THEN 

" code for TEST node •• 
\ ELSE 

•• code for RUN mode •• 
\ IFENO 

This variable contains the name at the PRINary OUTput 
file. In RUN mode this is the nsw control statement file; 
in TEST mode this is the file designated by the test mode 
parameter on the SES call (default Is SESTEST); and in 
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HELP or STATUS mode this is the file designated by the 
help or status mode parameter 0*1 the SES call (default is 
OUTPUT). PRIHOUT is par t i cul arfy useful I n HELP mode for 
directing the descriptive information about the procedure 
to the file selected by the user* 0^ the SES call* This 
may be accomplished as follows * 

\ IE MODE » HELP THEM 
\ ROUT FA«PRIHOUT 

•• descriptive Inforwation about called procedure * 
\ ROUTEND PRIHOUT 

\ STOP 

\ IFENO 

Sfttfi 5 in HELP or STATUS mode* a PARMEMO directive is 

interpreted as a STOP directive^ to prevent a orbcedure not set up 
for HELP or STATUS mode from doing strange or* undesirable things. 



81.1 i£L£aiiMii^liaa£-Q£«Q££aAIiQli 

As stated above* the mode of operation for a procedure Is 
selected by a parameter to the SES processor. 

TEST mode way be selected by one of the keywords 5 TEST» TM# or 
T. For example J 

ses» test.procedure.nanie I lst.of«>ar*aHieters 

processes procedure '•procedure. name*' ii TEST mode* and place the 
generated control statements on file SESTEST; s*hereas : 

sesf t'fliy.f I le«procedure.naHie 1 1st. of. parameters 

processes procedure "procedur e.name" In TEST !?«odef but places the 
generated control statements on file "my. file". 

HELP mode may be selected by one of the keywords s HELP or H. 
For exampi e i 

ses^help.procedure.naie 

causes procedure "procedure. name** to be processed in HELP mode* and 
any descriptive information available is olaced on file OUTPUT; 
whereas 5 

ses>h»my. Info .procedure. name 
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causes procedure "procedure^naiae" to be processed In HELP «ode* but 
any descriptive Information available is placed on flie ••my^info"* 

^filL£ • that when cat ling a procedure In HELP reode* a list of 
parawetcfs should Qfit be given. HELP for a group of procedures may 
be obtained by one call to SES» as foHoiis s 

sesf hei p*proc.ll proc.2r prdc.3 

STATUS i»ode way be selected by one of the k^eyitords J STATUS or 
S» For example : 

sesf Stat us •procedure Jn a le 

causes procedure "procsdure^name** to be processed In STATUS mode* 
and change information available Is placed on file QUTPUTj whereas ; 

sesf s««y«change. pro cedure.nawe 

causes procedure "procedure^name" to be processed In STATUS mode* 
but any change Information available is placed on f I I e '•my^change'** 

tlfiil£ * that when calf ing a procedure M STATUS mode» a list of 
parameters should aat be given* STATUS for a group of procedures 
may be obtained by one call to SESf as follows : 

ses>status«proc.l$ proc.2» prbc.3 
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C 1 . £I£QE.Ma«IM£Q£MMii£^iiSSiS£i 



This appendix describes the iiessages produced by the SES 
processor when errors are detected. SE5 error messages have been 
made as self-explanatory as possible* When an error is detected by 
SESf a message Is printed In the form? 

♦* E CL 11001 J EXPECTING ••nawe found Integer* for* parameter I" OH 
COHMANO STATEMENT 

The E at the beginning of the line Indicates t^ls Is an error 
message* 

The CI Is an abbreviation for the Systen Cbfniand language used by 
SES to do syntax processing* 

The number 11001 Is an error code assigned to this error 
condl tion« 

The text which follows the error code describes the error in 
detail* Appended to the end of the text Is the I Me number of the 
line being processed by SES* In this ^Trst examples it is the 
command statement which is in error* 

After the error message* SES outputs th?» fine It was processing 
when the error was detected* followed by a fine containing an 
up.arrow at the point in the line where the error' was detected* 

SES*REWRITE I»123 0«ABC 

Usually the error actually occurred on the token Just before the 
up.arrow* 

Here are two more typical examples of error messages? 

♦♦ F CI 11007J REQUIRED PARAMETER ilSSING ••I'' ON COMMAND 
STATEMENT 

SES.FORNAT 



*♦ £ CL llOlli UNKNOWN KEYWORD "NVLS'' 0^ LINE * 7 OF PROC SEGMENT 
MYPROC 

PARN KEY « C»group«» *gn NVLS « 1 ^Ai 

Other abbreviations used In SES err'or' messages are SE* which 
means the error was detected In the processor Itself* and UT* which 
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01.0 ^£!iir£aail^i-.lIMIiii«fi£KEi£Iia!i 



*'««*Wfiat ii the yse of repeating all that 
stuff*** the Nock Turtle lnter*rupted> "If you 
don*t explain It as you go ont It's by far the 
most confusing thing I ever hear'dl^ 

Lewis Carroll 



This section gires a se^l-foffaal description of the syntax used 
when writing procedures for and calling tha $ES.' The description is 
not intended to be rigorous* First we introduce the "fset a-l anguage** 
used to describe the syntax; second the character* set used by SES is 
defined; and finally the syntax description Itself Is given. 



01*1 lai^MEIA-LiMayASf 

This section describes the symbols used In the description of the 
SES syntax. 



::* This symbol should be read as ♦•Is defined to be". 

I This symbol is used to Indicate alternatives* for 

example: A S B roeans that either A or* B is allowed. 

<lte«n> This group of syinbols denotes that Item is to be 

treated as a syntactic unit In relation to 
surrounding meta symbols. 

titeml This group of symbols denotes that Item is optional* 

I.e. zero or one occurences^ of Itei are allowed. 

Citeml This group of symbols denotes that Item may be used 

zero or more times. 

Spaces aire used in the syntax description to improve Its 
readability* however they are not part a^ what's being defined 
unless otherwise noted. 
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There are a few instances where some of the meta symbols 
themselves are part of the syntax definition* and when this occurs 
the fueta symbol is underl ined* for exafsplei 1 means the J character 
and not the meta symbol* When an _ appear*s alone* It means Itself. 
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Di,0 SEMI-FORMAL SYNTAX OESCRIPTION 
01. Z CHARACTER SET 



01.2 ailM^£I£S-S£I 



Characters used for HAHES 



A 


• • Z a • « z 






letters 





.• 9 ...*,.•• 






Decinai Digits 
UnderT 1 r^e 


$ 








Ool 1 ar Si m 


# 








Pound 


a 








Coflinierci al At 



Characters used for INTEGER CONSTANTS 

•« 9 ••*«••«•••«••«««••••* Oecinar Digft«; 

A •• F a •• f ••••••«••• Hexadeoiwat Digits 

C •«•••••«••••••••««••««•••« Open Parenthesis 

) •••«•«••••«•••••*«•««•«••• Close Parenthesis 



Characters used for OPERATORS 






Plus Sign 
Minus Sign 
Aster isle 
Slash (Slant! 
Equal S I gn 
Greater Than S I qn 
Less f han S i qn 



Characters used for PUNCTUATION 



Blank ( Space) 

Comma 

Open Parenthesis 

Close Parenthesis 

Per i od 



Character used for STRING DELIMITER 



Apostrophe (Single Quote) 



Character used for CQMMMENT DELIMITER 

** •«•«••••••••••••«••••«•••• (Double) Quote 
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(Default) Character used for SU8STITUTI!I'4 0EtI»1ITER 

€t •••««••«•«•«•« ••-•«•«•«««•« AnperS'^f^o 

CDefaultl Character used for DIRECTI^TE HEADER 

\ «•••••••••«••«««••«•«••««• Reverse Slash f SI ant) 



Mai£5 Any ASCII character not fisted li the abave character set 
has no meaning to the SES processor** These characters may 
however be used In strings* comients* or as data 
characters* 
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D1,0 SEHI-FORMAl SYNTAX DESCRIPTION 
01.3 SYNTAX 



01.3 51MIA)S 



01.3.1 BASIC DEFINITIONS 



<upper case letter> s s^ A 5 6 J C J 1 E T F ! G ? H 

I Q 5 R J S S T ! U ? y t W I X 
} Y J Z 



<lower case ietter> :sa a " 



q I 



b ; 
j J 

r 1 



I 1 
t % 



<letter> ?5~ <upper case letter> 



<declfBal d$glt> s s» ? 1 1 2 J 3 J 4 I 5 1 6 t 7 I 8 ! 9 

<hexadeclfi!al diglt> J s* A I B J C ! I E t F 

SaJblcSdteJf 

<dlgit> s:» <decimal diglt> 

J <hexadeclmal dlglt> 

<base> w 2 S 3 J 4 J 5 J 6 ? 7 J 8 ; 9 ? 10 
J 11 5 12 S 13 S 14 J 15 S 16 
Dl.3.2 TOKENS 



This section defines the building bTiJcks 3f SES syntax* 
collectively referred to as tokens. The Interna* token scanner of 
the SES processor is made available to the procedure writer by means 
of the built-in function TOKEN. 



<token> s:» <na»ue> » <nyinber> * <string> 
\ <del imi ter> \ <operator> 

<name> sjs <alphafoetic char> C<alphabetlc char> ! <decimal dlgit>> 

<alphabetic char> ::« <letter> \ ^ \ % \ % \ '^ 



<upper case narBe> ?5« 

<upper case letter> C<upper case 1etter> ' <deci»uai digit>> 



All names are limited to thirty-one characters In length* except 
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procedure names and procedure identifiers* i#hlch are I Incited to ten 
characters. yith the exception of <upper case na'Re>s> any nune laay 
be specified with either upper or lower case fettersf but before a 
name is used all letters In it are converted to upper case. For 
instance the names? ABC# abc> aBc# and so oif btq all equivalent* 
(This includes any of the **special" naites* such as 00> THEN* WHEN* 
etc. In this description* however* these ?ianes are always spelled 
out in upper case letters.) 

<varlable naffle> S5« <na!i^e> 

<function naffl€> ti* <naroe> 

<para!neter name> sj« <naf!ie> 

<directive name> s:« <name> 

<assignee> 35- <paraweter naffle> ' <varlable nane> 

<procedure naiiie> ::« <narae> 

<procedure ldentifler> 55» <upper case r\^me'> 

<nuniber> ss« <decifflal digit> €<digi t>> C t <base>l J 

<string character> 5S» *' 

J <any ASCII character except •> 

<strlng> j:* K<string character>>» 
<constant> SJ» <string> S <number> J <iaie> 



<delii!ii ter> : :« » 5 ( J ) ? « ! . 1 ..C.l 
I <end of llne> 

<operator> Js* <graphic operator> ! <'nf^eii5onl c operator> 

<graphic operator > ::« ♦* I ♦ 5 / I If ! 4- 1 - t + + 

? = J /« J <> J 1 J S« \ > ? \* 

<}finewonic operator> ::« AND • OR S XOR \ NOT 
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01.3.3 USE OF SPACES 



Before discussing nherr and how spaces ca^i be used we will first 
define the syntax of comments* 

<cof!iment> ?2* »*C<any ASCII character exceot *•>>»• 

In almost all cases a coaiiaent Is treated Identically to a single 
blank cfsaracter^ and 2 or wore contlguojst blank characters lor 
comments) are treated as a single blank character* Blank characters 
and coffifflents treated in this manner are knoi*n as spaces. 

Spaces may be used between tokens to inisjr'gve readability and In 
general may be used to replace cosiinas whei used as arguwentt value* 
or parameter separators* Spaces lusl be jsed to separate tokens 
when no <del i rol ter> or <graphic operator> can be used to separate 
thei. For exaaple the spaces between the tokens on the following 
line (flust be presents 

VI AND V2 

whereas the following two expressions are equlyalent? 

VI ♦ V2 
V1+V2 

Further* the following value list contains 2 values? 

< X, -3 I 

whereas the next contains only 1 values 

I X «3 ) 

namely the value of the expression X-3. 

Spaces within character strings reoresent themselves* and 
comments may not be used in front of the \ whicli occurs at the 
beginning of directive lines* nor following the continuation signal 
at the end of directive or call lines. Lines within procedures 
which ^T e not directives or continuations of directives or lines 
which are read using the ACCEPT directive* are treated as unquoted 
strings* and therefore spaces are significant In them. Irfhenever a 
line is read by the SES processor* trallHg blank characters are 
deleted. Also* It is legal to precede the V ^f a directive line by 
one or more blank characters. 
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01,3.4 EXPRESSIONS 

<eKpr> s?a <lterw> C<or> <lterro>> 
<or> S5« OR r XOR 

<fterm> s r« <lfactor> CANO <lfactor>> 

<lfactor> !s« CN0T1 <lpri}Rary> 

<l pr iraafy> 2:« <sterm> {<rel op> <sterii>> 
<rel op> «!« « t /= J ^ J 1« 1 ^ 1 V* 

<sterm> :j» <terfii> C++ <terf!i» 

<teffli> !s« C<term op>3 <factor> Kt^rm oo> <factor>> 
<ter« op> : :« + » - 

<factof> 5S« <pr|jaary> C<factor op> <prl!!!ary>> 
<f actor op> 3J« ♦ I / J // 

<prlmary> :2s <operand> C** <operand>> 

<operand> s ?» <variable reference> 
<function refefence> 
C <expr> ) 
<constant> 
<r»ul t> 

<nuH> ss* 

<variable reference> ::» <yariable na!!i»> 

<functlon reference> it* <functlon na'!!e> <arguTients> 

<argy}«ents> six c C<arg> C» <ar9>ll ) 
! <nuH> 

<arg> 5s« <name> » <expr> 



<lnt€ger 8xpr> 5s« <expr> 
<strlng expr> s:« <expr> 
<boolean expr> it* <expr> 



•• wust resofva to an Integer »• 

•» must resolve to a string •• 

•• must resolve to an integer " 

»♦ If the value Is zero # It •» 

" Is taken to be FALSE " 

" If non-zera* lt*s taken •• 

*• to be TRIE " 
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01. 3*5 FOREIGN TEXT 



Foreign text is primarily used for parasReter vaiiies iililoti are to 
be in turn used as parameter lists {e»g«» to sacar^dary procedures) 
or simply to prevent the SES processor from evaluating an 
express Ion. 

The scanning of foreign text is totally different frofli scanning 
*»norBial*» text* The characteristics of this special scanning are 

- parentheses are "balanced** 

- single and double quotes are "aiatched* 

- if not contained within parentheses* single quotes* or 
double quotes^ the tokens: coiuiia» period* ellipsis 
(«•€•>}» and close parenthesis «il I I terml n ate the scanning 
(and thus the foreign text value). In addition* spaces 
which are used to separate nanes* nuinbers* or strings from 
names numbers or strings will terminate scanning; as will 
an ••unenclosed" open parenthesis iihlch follows a string or 
number (Note* that an open parenthesis following a name 
does not terminate scanning - this Is because function 
references are allowed in foreign text but the foreign 
text scanner doesn't evaluate what It scans* and thus does 
not know if the name is indeed the naiie of a function)* 

Foreign text may also be described as having the general format 
of an expression* but the expression is not evaluated when scanned 
as foreign text. During scanning comments and blanks not contained 
within single quotes are "thrown away** and single blank characters 
are Inserted between tokens which would otherwise not be separated. 

The following example illustrates some of the i dl osyncr acl es of 
foreign texts 

\ vllst « Ma b c Cd e) '^p q«tttr» s«« 123t8l Cxftv^-S)) )« 

\ count » VCNT Ivllsti • 2 •• 

\ value « VALS fvlist* 3) •• 3 •• 

\ sllst » 6EMLIST lvllst# Index) •• 4 n 

The first line defines a value list In the variable vllst* tine 
2 sets the variable count to the value 6. Line 3 sets the the 
variable value to the values 

CCD E) 

and line 4 sets the variable sllst to the value? 

AfBfCCD E)f*p q»»r> s«*123(8) * I X, I Y43) ) 
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The next exapple lllystrates how a paraieter list inay be passed 
as a foreign text parameters 

\ pMst « *( l«liiflle ••columns" cois«l«*80 o«out !• 

\ count « VCHT CpllstI 

V lOM « VAiS Cpiistf Zf LOVI 

\ high « VALS <pMst» 2f HIVI 

\ slist « GENLIST (plisty indexl 

Count Is set to 3| lott is set to: 

COtS«l 

high is set to 30; and si 1st is set to: 

I«INFIL£*C0LS»1,,80#(J«I}IIT 
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Dl,3,6 PARAMETER LISTS 

<paraflietef irst> 55* C<paraiiieter> CC#1 <Paraineter>>3 

<paraffletef> 2Ss C <par afneter naiBe> C*31 <yalue I1st> 
; <parameter name> 
I <nuM> 

<Yalue Hst> s?= <yalue> 

S C C<¥alue> CC#3 <valus>>1 ) 

<value> ss« <yafi2€ side> C*#C«> <value sMe>l 

<yalue side> S5« <expr> J <foreign text> 
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Dl.3.7 SES PROCESSOR CALL 

<csep> 5s= Ifl <end of llne> 






<Pfoc caH> sj» <procedure na!Be> C#3 <paraiieter* list> <csep> 

<control stateraent> ? :« <string> 

<control stat€fflents> is* <control stat8isnt> C<csep>3 

C£f 3 C<control stateiiafit>3 C<csep>3> 

<call 8leinent> SJ» <proc call> « <contfbl state!f!ents> 

<SES call> 55* SES C> <paraweter ljst>1 • 

<caM elefBent> C<cal1 B\Qme^t>y 



Because of operating system restrictions* a <parameter list> 
following the SES (processor naniel must have explicit punctuation. 
That is to say* commas must be used to s«3ar'ate parameters (and 
values) and equal signs must be used ta separate parameter names 
(keywords) from their value lists. 

Also* the operating system is not vieii aci^tialnted with lower case 
letters* so only upper case should be jsed; however* NAM/IAF (or 
TELEX) and the SES processor alleviate this Droblefn by converting 
lower case letters to upper case on coniflnand and continuation lines* 

When <control statefiients> are used in a <S?=S call># the SES 
processor insures that they are all ••orboerfy'* terminated* i.e.* 
each <control stateirient> string is scanned for a right parenthesis 
or period and if neither of these characters Is fouind* a period will 
be appended at the end of the striigl if however* a right 
parenthesis or period is found* the string will be left alone. NOTE 
that this is the only validity checking o^ the <control statej»ent> 
done by the SES processor* 



01-13 
CDC - SOFTWARE ENSINEiRIHG SERVICES 

18 December 84 
SES User»s Handibook REV? 4A 

Dl.O SEMI-FORMAL SYNTAX DESCRIPTION 
01.3.3 SUBSTITUTION 



01.3.8 SUBSTITUTION 

<substltute> 5J« <para«€t€f naffle> * <var1ib1e fiame> 
<de fault sybstltutlon charact€r> !s» S 
<altefnate substitution character> ss* 

• * * ff i -> » ^ * i * i I « * « " « T « "" J / f t « < ^ » » » . f » t • 1 . 

<substi tuti on char> s s« 

<defauit substitution cbaracter> 
S <alternate substitution character^ 

<subst I tuti on> : s « 

<subst i tut i on char> <substitut8> <sabsti tuti on cfiar> 
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Dl.3,9 PROCEDURES 

<procedyre> J :« <procedure ldentlfier> C<procedure nne>> 

<procedyfe liiie> :s« {<proc€dure line 8le?f!ent>> 

<procedure line element> t:* <subst i ttit I on> 

J <any ASCII charactef> 

The process of substitution applied to a <Procedure llne> yields 
an <ob ject I ine>« 

<obj€Ct line> SJ« <directive line> 

* <e»ipty line> 
5 <data I lne> 

< default directive character> st* \ 

<alternate directive character> 5!= 

<directive header > ::« 

<defaylt directive character> 
• <alternate substitution character> 

<dir€ctlve llne> :s= <directive header> <dlrective> 

<empty line> :?« 

<data line> 5 s« <any line which is not '•e'noty*^ and does 

not begin with a directive header> 

tifltfi* <empty line>s may contain con-^ents enclosed in double 
quotes* 
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01.3,10 DIRECTIVES 



<directivs> n- <assi gfU!ient> 

<jf whi le> <bo<ilean expr> Kthen d3>1 
<exit cycle> CWHEN <feoolean 8xpr*>1 
<directiv€ naffle> <paraineter llst> 

<assi gnfBent> J J* <assignee> - <expr> 

<\f *#hne> ii* IF r ORIF t WHILE 

<then do> s :» THEN 
I DO 

<exit cycie> ss« EXIT I CYCLE 



01-16 
COC - SOFTWARE EMGIMEERING SERVICES 

13 December 84 
SES User's Har^dbook REVs 4A 

01,0 SEHI-FORHAL SYNTAX DESCRIPTION 
01.4 LINES AND THEIR CONTINUATION 

It is soflietJmes necessary to pass more otraiaters to a procedure 
Cor give more parameters to a directive) than will fit on one line* 
To handle this problem* SES processes cont I ?^ nation lines* 

The ititM^Lt^ net result of using continuation lines is to 
construct an unbroken line of up to 200D characters for calls to 
SiSf or 256 characters for an SES directive* 

Continuation fnay only be used in conjunction wltli SES directives 
and when calling SES to process a procedure. Continuation is 
signalled on the line *«hich is to be continued* not the continuation 
line Itself* Note that the <cont i nuat ion slgnal> Is not considered 
to be part of the line* The mechanisra for* doln^i tl^ls is defined as 
fol lows J 



<Hhole line> ::» 

<line starter> <stuf 1> I <continuatlon slgnal> 

<stuf 2> C <contlnuation signal> 

<stuf n> > J 



<cont inuati on signal> SJ* *•€*> 

<line start€r> 2i» <directive header> <na!ne> 

J SES <paraf»eter llst> 

<stuf i> 5S« <whatever belongs with the line start€r> 
•• 1 <« i <» n •• 



The effect of this Is as If <whole line> had been specified as: 
<line starter> <stuf 1> C<stuf i» 
Mate* Syntactic units (tokens) nj^ cross line boundaries* 
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ACQUIRE is a prografli that enables easy retrieval Cacqulsl tionl of 
permanent files. 

ACQUIRE combines the functions of the N1S "ATTACH" and "GET" 
control statements. For each fiie specified ACOUI^E deteraiines If 
the file Is already local to the Job <(jfil ess suppressed by the PQ 
parameter^ see below):> if so It is rewound? If lot* then for each 
one of a list of user naiaes* an ATTACH i s attempted {viaitlngy if 
necessaryt until the file is not busy}# and if that fails a GET Is 
tried* If* after ail this* the file Is stiff not local* an 
appropriate dayflle message is issued* 

Unless the A tabortl paraweter is specifledf ACQUIRE aborts only 
because of control statement foriaat or argjment srVors* or because 
of a permanent file manager <PFH) detected error! and not because 
one (or more) of the specified files could not be found* 

The control statement format for ACQUIi^E Is 5 

ACQUIRiClfnl»pfnl>lfn2«pfn2f./^plf»p2»^'».l 

ifni Is the (local) naroe of the file once It has been ACQUIREd 
(note that this is the nai»e used In naking the "is the file 
already local?** test) 

pfni is the permanent file name for the ^Ife (If «pfni is omitted* 
pfnl is assumed to be the same as l^ni) 

opi specify options used for acquiring the fMefs) s 

A specifies that I f a file Is not found* ACQUIRE 

should abort 

NA is the opposite of A (and Is the default) 

PQ specifies Permanent Only* l*e** that if a file is 

already local* it is returned and then the ATTACH 
and GET are attempted 

UN^users specifies a list of user names to be searched for 
each file (the user names are separated from each 
other by commas) 

M«mode specifies the access iiode desired for the file 
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CREAO or R — the default» WRITE or W* or EXECUTE 
or £)• If the file is l9c?il» the niode wi 11 f^ot be 
changed* To insure the node will be changed* the 
PO parameter should also be saecl?led* 

pyi'pu specifies the permanent ^ne*s password 

PN«pn specifies the packname far* the pertiianent file 

yhen ACQUIRE Is attempting an ATTACH or SET» If the file Is busy 
or i f a permanent file utility Is active* the following message Is 
Issued and the request Is retried J 

- WAITING FOR PFN«per«ianent«f Hejnawe llN«ttser.naBie 

When ACQUIRE is attempting an ATTACH or GET* if an error Is 
detected by PEN the fol lowing message is Issued and ACQUIRE aborts J 

- ERROR WITH PFN»per«iafient_f i I e.nane U^^user .naaie 

In both of the above cases* the designated iiessage is preceded by 
a wore specific message generated by PFM* 
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EOT is an enhanced version of the stafidar'd MOS text editor 
CEOITI* EOT incorporates column sear chesf wodi f i ed FINO and FINOS 
coflifliandsi Input and Output file and TA8 specification on the EOT 
cali# control over terminal interrupts* IMi^JT ?100E ootlons* multiple 
entries on command lines* command buffers* permanent file functions* 
and miscellaneous other additions* 

User documentation can be found on TOOIOQC CSESD009). 



Fl .1 £flJL.Ca!iISQJL.iIAIM£tlI-£QEaiI 

EDT*Clfnl3*Clfn2 3*Clfn31*Ctab1.Ccradstr1 
Ifnl - name of the file to be editef! 

Ifn2 - name of the file containl'ig the editor commands 

(default » INPUT) 
- i f 0* an END command is executed after processing the 

commands in cndstr 
~ if 1* commands are read fron file INPUT after 

processing the commands in cidstr' 

Ifn3 - name of the output file (default » OJTPUT) 

tab - tabset to be used by EOT 

cmdstr - editor Command String to be executed If Ifn2 » or 1 
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EXTRACT Is a prograra that enables easy retrieval of records from 
permanent file (or local) libraries* 

EXTRACT Is sjwilar In function to the mS "GfR" statement. It 
differs from «GTR»« in the following ways? 

o EXTRACT insists that the library to be searched has a 
directory (a directory can be built tjsl?^ci the NOS utility 
«LI8E0IT«). 

o The record type parameter for EXTRACT* If given* applies to 
all records to be extracted* and If Tot given, on! y the names 
of the records are used when searching the library* 

o Each extracted record Is copied to its our* local file by 
EXTRACT* rather than all to the same file. 

EXTRACT does not insist that the library to be searched be 
local to the job when It's called* bjt AC9tJI^E»s the library 
from a permanent file catalog. 

The control statement format is? 



EXTRACTd fnl«rnlf lfn2«fn2».../1ipl»op?f .U.l 

Ifnl Is the local file name given to the record once it's 
extracted <lfni is REWOUND before a^^d after' the extraction 
takes place)* 

rnl Is the name of the record to be extracted (If omitted* It Is 

assumed to be the same as Ifni). 

opi These parameters specify options that control the extraction 

process s 

A Specifies that if a record is not found* EXTRACT 

shoui d abort. 

NA Is the opposite of A (and is the default). 

T«rt Specifies the record tvoe (If given* it applies 

to ail records being extracted; If omitted* only 
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the record names are ^jsed when searching the 
f I b r a r y I . 

Isfibnawe Specifies the name of the library to be searched 

for the records Cif oiwftted* ♦•PR0CLI8« is 
assymed)* 

LFN^IIblfn Specifies the local file naie for the library 
<if omitted* the «llbna«e*» frbn the L paraeter 
Is used)* Note that this Is the name used to 
make the «is file local??" test when ACQUIRing 
the I ibrary. 

UN=un Specifies the user ntie of the permanent file 

catalog to be searched! forTlbname" if It's not 
already local (If onltted» the current user Is 
assumed)* 

PW«PM Specifies the I ibrary* s oernanefit file password* 

PN«pn Specifies the library's per'nanent file packname* 

Valid record type designators are documented under the 
description of the "CATALOG'* control statement in the NQS Reference 
Hanuai • 

In addition to these standard types* there's one more "type" 
processed by EXTRACT^ which Is designates! by "TXT"* This "type" is 
used to denote "TEXT" records thatt when extracted* are to have 
their first line (which contains the record's name) "stripped off"* 
This is useful if* for example* one has records containing 
directives for a NOS utility* In which case the name of such a 
record is In ail likelihood an illegal directive to the utility 
program* 

EXTRACT aborts under any of the following conditions: 

o format or argument error(s) on the control statement 

the specified library could not be A3JIREd 

the library file does not have a directory as the last record 
before end-of-i nf or mat ion 

Note* however* that EXTRACT doesn't abort If It does not find any 
of the requested records <only an infornative dayfile message Is 
issued)* unless the Abort parameter Is coded on the call* 
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If the library file is not local 
caliedf it is RETURNed Khen EXTRACT 
library file is local, EXTRACT 
t er IB i nation* 



to the job when 
teriBlr^ates noma I lyi 
REWIND* s It or lor 



EXTRACT is 
but* if the 
to normal 
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SESHSS is a program which copies the coi^nent field of Its call 
line to a file. The control statement fornat 1st 

SESHS&f f i le.nessage 

file Is the na?»e of the file to receive the message Cif 

Oflilttedf OUTPUT is assumed) 

message is the raessage to be written to the file 

The message is written to the file only If the file is a terminal 
file* or If "file** Is explicitly quoted on the call fine. 

SESHSS is used In procedure files to Inforn the user about what 
the procedure Is currently doing. It is also used for creating 
files of input directives to utility progra^ws when such directives 
are dependent on execution time considerations. 
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JQBID Is the program used by the SES PRI^ITID procedure to produce 
"large print" banner pages* 

The output produced is one or pore oages of 5 lines of block 
characters at 10 characters 9er line* All aioty character positions 
and lines are blank ftlied* Additional paqes of block lettering Is 
produced if any information is specified following a fifth delimiter 
character* and so on* 

The input to JQ8ID is a string of characters in the following 

forw s 

I i nel/ I i ne2/ I i ne3/ 1 1 ne4/ I i neS 

or 

/////♦I Inel+line2+l ine3+l ine4+line5 

In the first forw the slant (/) character' is taken to be the 
deilffliter between lines (l»e*f it is the default deliwiterl* The 
second form must be used when you want one or* more of the lines to 
contain the slant character* In the exauole above* the delimiter 
has been changed to a plus <+) character* 

ttaljS • that only characters with ^ 6-^lt display code 
representation can be given to J08I0* to produce a colon (s) on 
output you should use a percent sign (%) on Input* Unnecessary 
delimiters after the isessage data should be oniitted* otherwise a 
trailing deliniiter may be printed. 

Once JQ3I0 has broken the message field Into inessage lines based 
on the delimiter character* the front of each field is examined for 
the following sequences of characters i 

)DATE 
)TIM5 
)£TAO 
)AHPH 

Whenever these character sequences are found* the message line on 
which they occur is replaced with the curreit value of the indicated 



)OATE 


17 SEPT 74 


ITIHE 


14n8«21 


lETAO 


74/09/17 


)AMPH 


3105 pn 
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parameter* (NOTE that ttie right parenthesis wust be the first 
character of the message line on which it occurs). 

The aboye "commands* produce the follow1?^g tyPes of results s 



{date r%versedl 



GRAPL/OLDPl/TAPE »/ 7777 

TEXTJAB/CQHPILE/ OF/ lOATE/ ) TIHE 

/////♦CREATED 0N+ 17/09/74*+lATESr RilM + J ATE 

SEND TO/HEADQWVALE/ROOM 888 

/DAYFILE/DUHP/IETAO 

The above calls produce the results sho**! below ; 

6RAPL TEXTUAB CREATED ON SE10 TO 

OLDPL COMPILE 17/09/74 MEADrjWVALE OAYFILE 
TAPE « OF Rim 839 OUHP 

7777 17 SEPT 74 LATEST RUN 74/09/17 

13135126 18 SEPT 74 
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SofS€tii«es the header laaterlal generated by TXfFHRH is not desired 
or TXTFORH is unable to produce a needed header format. The TXTHEAD 
utility processes a TXTFORH output file* which contains special 
TXTHEAO Instruction pages* and removes the o1?! header material 
and/or inserts the new heading material* Addl ti onal ly f an 

incrementing page number can be produced at any pos I t Ion ulthin the 
header text* or the TXTFORM page number may be oassed to TXTHEAO for 
placement into the header region. 



///HEAD 

///END 
///PAGEC-3nn 

///LINEnn 
///COLUMNnn 



///ADONOnn 

///DELETEnn 

///OLOHO 
///NEMNO 



kLllQU 



New heading material fof^bws until another /// is 
encountered in columns 2»1»4« 

Usually marks end of sped af hsadi ng material* 

Set page number for next »age to m. If negative* 
the page number Is not printed until it increments 
to I. 

Line nn of header on which to put a page number* 

Column position for units digit of page number is 
nnf for TXTHEAO generated Page nos.# and for 
TXTFORIi generated page numbers the column position 
specifies the location of the left hand side of the 
page number* (Count Mclwdes carriage control 
col umn) • 

Number of header lines t3 be added is nn* Default 
is add all lines given* 

Number of lines to be deleted frbn top of each page 
is nn* 



Use the TXTFORM generated oage nos* 

Use the sequentially generated TXTHEAD page nos* 
This Is the default condition* 
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To give these commands to TXTHEAD* the foMoi*ln(| type of format 
should be used in a TXTCODE docufwent at tiia place where the change 
Is to occur* 

\asls 

Smarglnl 

\!ength80 

Vpage 

///head 

* HEADER TEXT * 

* ♦ ^age 

j4c^ sdcsk^sfic 3i6c^ ^^ -Ac ^ 3lc sfic 3k Ai sic 

/ffef)d 
///pagel 
///Iine3 
///col umn65 
///deletes 
XwarglnlO 
\l ength62 
\bi ock 
\page 

yat^ * 

Header information as well as any specifiable information may be 
defined or redefined anywhere. Old ralues r'emain set until 
replaced* The page nuinber may be eliminated by specifying ///lineO 
or any out of range value* 

Any size header is permissible* It Is also possible to supply 
folio information for pages by putting the oags eject at some point 
after the first line of header material*. Column one of the header 
information is assumed to contain printer control characters such as 
"blank*** ^f -» Of etc* 

A great deal of flexibility is available for special page 
formats* 
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The following is a table of conversion performed by JABFORH : 



-A- 

~6xx> •••>zz- 

-88xx> • ••> 2Z~ 

-C- 

-E- 

-f- 

-Gxxf «• *fzz^ 

-HN-Y,YC..«C 

-IN- 

-KH- 

-I- 

~M- 

-Nx- 

-0- 

-p- 

-Q- 

-R- 

-SN- 

-T- 

-.TN- 

-VxXf mm mfZZ- 

-VVxx# •••>2Z- 

-z- 

— CHINUS HINUS) 

-ANY COMBINATIONS OF EDIT CQDES- 



\A 

\ 3 x X ♦ • ^ • ♦ ?■ z 

VB3xx» • ••% ZZ 

\C 

\H 
\F 
\ 3 X X » • • • » 2 z 

\HN 

-.* * • ■* C 

\x% 

\<H 
M 

\n 

\^x 

\0' 

\!> 

\Q 

\R 

\sN 

\T 

\.TM 

\Vxx» •^i«9 zz 

\VXX» • •«? 2Z 

\XN 

\^ 

\ 

VCOHBIMATIQN OF COOES 
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<-ARA8IC4- 

♦AUTO* 

*CAROtNXX+ 

♦CHANGEfC^ 

♦OATE-i-XXXXXX 

♦OERTHXX^- 
4'0QUBLE + 
♦EIGHT* 
♦ENOT* 
♦FOLIO+XXXXXX 

♦HEAOA* 

♦ HEAOA»XX^- 

4-HEA08+ 

♦HEAOB'XX* 

+HEAOC+ 

♦HEADC«XX+ 

*aUST+ 

♦LENGTHNN* 



♦LIST<X#,..fX)+TITLE 



+HARGINXX+ 

^-NQAUTO* 

^•NOJUST + 

+NOPTAB+ 

♦NOSEQ+ 

^-NOSOURCE* 

♦PTAB+ 

>RECORDXX»YY+ 



♦ROMAN* 
♦ SEQ + 



UlEQM 

dlscardsd 

discarded 

\REC0RD1,XX 

\CHANGEfC 

\DATE 

XXXXXX 

\FORMAT*,XX 

\SPACE2 

discarded 

\ (See +TABIE+) 

XFOLIO 

XXXXXX 

\ HE ADA 

VHEAOA C*XX fflscardedl 

\HEAOB 

\HEA08 i^m discarded) 

\HEAOC 

\HEAOC C«XX discardedl 

\just 

MENGTHNN 

(After this* JABFORM only processes 
column 1 thru Mm ^^+1 to EOt is passed 
thru* I 

\LISTXf ,..»X 

TITLE 

(discards £>^ tnd R^l 

\MARGINXX 

discarded 

\NOJUST 

discarded 

XNQSEQ 

discarded 

discar ded 

\RECORDXX,Yr 

(After this* 
columns XX thrij 
and YY+1 to Ell 

dIscar ded 

\SEQ 



JA3F0RH only processes 
YY; column 1 thru XX-1 
will be passed thru«) 
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♦SETA+C 



+SETC+C 
+SETE+C 



♦SETQ+C 



+SETS+C 



♦SETU-i-C 



+SETTA81»XX#«,.fl5«ZZ+ 

4-SINSLE + 

♦SIX4- 

♦SOURCE* 
♦SUBTITIE+XXXXXX 

♦TABLE+ 



+TITLE*XXXXXX 

♦TODAY* 
*C 



•C*.«C« < apostr ophi es ) 
$C • • vC $ 



lUEQm 

dis carded 

<4A8FQR11 recognizes the C as an 
alter code fraii fiow on» ) 

discarded 

discarded 

(JA8F0RM recognizes the C as an e 
code froia now on») 

discarded 

(JABFORH recognizes ttie C as 
capitalize string code frois novr on«) 

discarded 

CJA8F0RH recognizes the C as the 
special character code from now on«) 

discarded 

IJASFORM recognizes the C as the 
ynderflne string code from now on*) 

\SETTA81XX»«..»15ZZ 

\SPACE1 

discarded 

discarded 

\TITLE2 

XXXXXX 

\CQHHENT 

♦TABLE* <In»iit thru next endt Is 
processed* but passed to TXTFQRH as 
coroment shifted to the right one 
space* ) 

♦ ENOT+ 

\ 

VTITLEl 

XXXXXX 

\TOOAY 

*C CC Is not capitalized -- ASCII 
6/12 TEXT4A8 inout does not use this 
f eatur e* ) 

C*.*C (cap! tal i?ed) 

\UNOER 

C « * *c 

\UOFF 



not 
a 
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lE^IMfi IXIEQEM 

/A + iplusl 

/8 3 Iclosing bracket) 

/C * (single quote* grave accent* or closing quotel 

/O $ Cdollar sign) 

/E ; Cseaiicolon) 

/F > Igreater than) 

/G < CI ess than) 

/H ^- Iplus) 

/I \BtANKl 

/J ^ (underline) 

/K % (percent) 

/L (unknown - blank) 

fn £ (ampersand) 

/N Mexcl anation) 

/O « (equal) 

/P * (asterisk) 

/Q (comnercial at) 

/R * (apostrophe or opening qitote) 

/S - (minus) 

/T : (colon! 

/y # (pound) 

/V £ (opening bracfcet) 

/W ? (question) 

/X * (asterisk) 

/Y " (quotation marks) 

/Z / (slant) 

/O 

/I 1 

/2 2 

/3 3 

/4 4 

/5 5 

/6 6 

/7 7 

/8 8 

/9 9 
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/ (space )C««C \COMHENT 

C.C 

/* * (asterisk) 

/» • (single quotes grave accsr^t* orclosing quote) 

/- - (mifiys) 

/♦ + (pius) 

/$ $ (dot far sign) 

/C C (opening bracket) 

/3 1 (closing bracket) 

/** •• (quotation marks) 

//A + (plus) 

//3 > (closing brace) 

//C "^ (circumflex) 

//O • (single quote* grave accefit* or closing quote) 

//E « (apostrophe or opening quote) 

//F \( reverse slant) 

//G IcoiiiiBercial at) 

//H + IplusI 

//I (space) 

//J ♦ (plus) 

//K r (vertical tine) 

//L - (mlnys) 

//N ; (vertical line) 

//M " (tilde) 

//O " (quotation narks) 

//P (space) 

//Q (space) 

//R (space) 

//S (space) 

111 (space) 

//U 4^ (plus) 

//V C (opening brace) 

//W ♦ (asterisic) 

//X ♦ (asterisk) 

//Y ♦ (plus) 

//Z \(reverse slant) 

/// / (slant) 

//£ S (ampersand) 

NOTES 5 

1) If JABFORM is passing columns* unprocessed data in the passed 
columns on Input is in the same cdlunns on output« Blank 
padding* when required* is done to accm^llsh this* 

2) All TXTFORIi codes are put on a line by themselves. 

3) All TEXTJAB codes (except 4-TABi£*) that have no TXTFORM 
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conversion is converted to EOL and a nesstge sent to ERRFIIE. 

CAUTION 5 

1) The TEXTJAB source XXX tyvyf converts to t 
XXX 

XUNDER 
YYY 
VUQFF 

Which lists as XXXXH* To get a space before t^e first Y> the 
TXTFQRH source must be changed to have a soace before the Y. 

21 TXTFORH can only handle line length uii> thru 100 characters on 
output and TEXT4AB allows 120. This ueans the ^-LENGTH* code 
Mill convert OK* but TXTFORH «lll not procB^s correctly* 

3) TXTFORM can only handle tab settings up thru 99 and TEXTJA8 will 
handle 119. This means a TEXTJAB SETTA3 alter code Mill convert 
OK* but TXTFORM nil! not be able to handle it correctly. 

E X ai^p i e : 

^S£TTAB7»i03,8«1134- 

This will convert to ? 

\S£TTAB7103*8113 - with tab number 71 and 81 with columns of 3 

and 13. 
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The following table shows the ASCII ch3r*3cter% and the Internal 
octal codas that represent them within the various character sets 
that are processed by the CONV utHlty. 
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CHARACTER SET TABLE 


: (USED 


BY CONVI 






ASCII 


N63 


N64 








ASCIf4 






GRAPHIC 


NBE63 


NBE64 


N612 


NBE63A 


N8E54A 


ASCIIS 


N612U 


N612 


s (COLON) 


63 


00 


7404 


072 


07^ 


072 


7404 


7404 


A 


01 


01 


01 


101 


101 


101 


01 


- 


8 


02 


02 


02 


102 


102 


102 


02 


- 


C 


03 


03 


03 


103 


10 3 


103 


03 


— 


D 


04 


04 


04 


104 


104 


104 


04 


• 


€ 


05 


05 


05 


105 


105 


105 


05 


- 


f 


06 


06 


06 


106 


106 


106 


06 


- 


G 


07 


07 


07 


107 


107 


107 


07 


- 


H 


10 


10 


10 


110 


IIB 


110 


10 


- 


I 


11 


11 


11 


111 


111 


111 


11 


- 


J 


12 


12 


12 


112 


11? 


112 


12 


- 


K 


13 


13 


13 


113 


113 


113 


13 


- 


L 


14 


14 


14 


114 


114 


114 


14 


- 


n 


15 


15 


15 


115 


115 


115 


15 


-. 


H 


16 


16 


16 


116 


lis 


116 


16 


- 





17 


17 


17 


117 


117 


117 


17 


- 


P 


20 


20 


20 


120 


120 


120 


20 


- 


Q 


21 


21 


21 


121 


121 


121 


21 


- 


R 


22 


22 


22 


122 


122 


122 


22 


- 


S 


23 


23 


23 


123 


1?3 


123 


23 


- 


T 


24 


24 


24 


124 


124 


124 


24 


- 


U 


25 


25 


25 


125 


125 


125 


25 


- 


V 


26 


26 


26 


126 


126 


125 


26 


- 


y 


27 


27 


27 


127 


127 


127 


27 


- 


X 


30 


30 


30 


130 


130 


130 


30 


-. 


Y 


31 


31 


31 


131 


131 


131 


31 


- 


Z 


32 


32 


32 


132 


132 


132 


32 


- 





33 


33 


33 


060 


05 


050 


33 


33 


1 


34 


34 


34 


061 


051 


051 


34 


34 


2 


35 


35 


35 


062 


052 


052 


35 


35 


3 


36 


36 


36 


063 


053 


053 


36 


36 


4 


37 


37 


37 


064 


054 


054 


37 


37 


5 


40 


40 


40 


065 


065 


055 


40 


40 


6 


41 


41 


41 


066 


055 


056 


41 


41 


7 


42 


42 


42 


067 


057 


057 


42 


42 


8 


43 


43 


43 


070 


070 


070 


43 


43 


9 


44 


44 


44 


071 


071 


071 


44 


44 
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ASCII N63 


N64 








ASCII 4 






GRAPHIC Na£63 


N8E64 


N612 


NBE63A 


N8E64A 


ASCII5 


N612U 


N612 


♦ CPLUS> 


45 


45 


45 


053 


053 


05 3 


45 


45 


- (MINUS) 


46 


46 


46 


05 5 


055 


055 


46 


46 


* (ASTERISK 


47 


47 


47 


052 


05? 


052 


47 


47 


/ (SLASHI 


50 


50 


50 


057 


057 


057 


50 


50 


( (LEFT PAREN) 


51 


51 


51 


05 


050 


05 


51 


51 


) (RIGHT PARENS 


52 


52 


52 


051 


051 


051 


52 


52 


$ (OQLLAR SIGNI 


53 


53 


53 


044 


044 


044 


53 


53 


« (EQUAL) 


54 


54 


54 


075 


075 


075 


54 


54 


(SPACE) 


55 


55 


55 


040 


040 


040 


55 


55 


f (CQHMA) 


56 


56 


56 


054 


054 


054 


56 


56 


. (PERIOD) 


57 


57 


57 


056 


056 


056 


57 


57 


# (POUNO) 


60 


60 


60 


04 3 


043 


043 


60 


60 


C (LEFT BRACKET) 


61 


61 


61 


133 


133 


133 


61 


61 


1 (RIGHT BRACKET) 


62 


62 


62 


135 


135 


135 


62 


62 


% (PERCENT) 


^ 


63 


63 


- 


04 5 


045 


63 


63 


" (DOUBLE QUOTE) 


64 


64 


64 


042 


043 


042 


64 


64 


. (UNDERLINE) 


65 


65 


65 


137 


137 


137 


65 


65 


1 (EXCLAMATION) 


66 


66 


66 


041 


041 


041 


66 


66 


t (ANPERSAHO) 


67 


67 


67 


046 


046 


046 


67 


67 


♦ (APOSTROPHE) 


70 


70 


70 


047 


047 


047 


70 


70 


7 (QUESTION) 


71 


71 


71 


077 


077 


077 


71 


71 


< (LESS THAN) 


72 


72 


72 


074 


074 


074 


72 


72 


> (GREATER THAN) 


73 


73 


73 


076 


076 


076 


73 


73 


a (CQMNERCIAL AT) 


74 


74 


7401 


100 


100 


100 


7401 


7401 


\ (REV, SLASH) 


75 


75 


75 


134 


134 


134 


75 


75 


"^ (CIRCUHFLEX) 


76 


76 


7402 


136 


13 6 


136 


7402 


7402 


? (SENICOLON) 


77 


77 


77 


073 


073 


073 


77 


77 
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ASCII 
GRAPHIC 



N63 N64 


ASCM4 


H3E63 N8i64 N612 N3E63A 


NBE64A ASCIIS 


7601 


141 


7602 


142 


7603 


143 


7604 


144 


7605 


145 


7606 


146 


7607 


147 


7610 


150 


7611 


151 


7612 


152 


7613 


153 


7614 


154 


7615 


15 5 


7616 


156 


7617 


157 


7620 


160 


7621 


161 


7622 


162 


7623 


163 


7624 


164 


7625 


165 


7626 


166 


7627 


167 


7630 


170 


7631 


in 


7632 


172 



N612U 



N6121 

7601 
7602 
7603 
7604 
7605 
7606 
7607 
7610 
7611 
7612 
7613 
7614 
7615 
7616 
7617 
7620 
7621 
7622 
7623 
7624 
7625 
7626 
7627 
7630 
7631 
7632 
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ASCII N63 

GRAPHIC NBE63 

C CLEFT BRACE) 

J IVERTICAL BAR) 

> (RIGHT BRACE) 

" CTILOE) 

DEL 

NUL 

SOH 

STX 

ETX 

EOT 

EHQ 

ACK 

BELL 

BS 

HT 

LF 

VT 

FF 

CR 

SO 

SI 

OLE 

OCl 

0C2 

0C3 

DC 4 

NAK 

SYI^ 

ET3 

CAN 

EH 

SUB 

ESC 

^S 

GS 

RS 

US 

* (GRAVE ACCENT) 



N64 
HBE64 



N612 NBE53A NBE^4A 

7633 
7634 
7635 
7636 
7637 
7640 
7641 
7642 
7643 
7644 
7645 
7646 
7647 
7650 
7651 
7652 
7653 
7654 
7655 
7656 
7657 
7660 
7661 
7662 
7663 
7664 
7665 
7666 
7667 
7670 
7671 
7672 
7673 
7674 
7675 
7676 
7677 
7407 



ASCII4 






ASCIIS 


N612U 


N612I 


173 


7633 


7633 


174 


7634 


7634 


175 


7635 


7635 


176 


7636 


7636 


177 


7637 


7637 


ODO 


7640 


7640 


ODl 


7641 


7641 


002 


7642 


7642 


01)3 


7643 


7643 


004 


7644 


7644 


005 


7645 


7645 


006 


7646 


7646 


0^7 


7647 


7647 


010 


7650 


7650 


Oil 


7651 


7651 


012 


7652 


7652 


013 


765 3 


7653 


014 


7654 


7654 


015 


7655 


7655 


016 


7656 


7656 


017 


7657 


7657 


02 


7660 


7660 


0?1 


7661 


7661 


022 


7662 


7662 


023 


7663 


7663 


0?4 


7664 


7664 


025 


7665 


7665 


0?6 


7666 


7666 


027 


7667 


7667 


030 


7670 


7670 


031 


7671 


7671 


032 


7672 


7672 


033 


7673 


7673 


034 


7674 


7674 


035 


7675 


7675 


036 


7676 


7676 


037 


7677 


7677 


140 


7407 


7407 
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Ge^er a I 

6/12 character set sup|>ort 

Field Length panagement 

Nested CALLs 

Default line length 

HaxI ffluiii I Ine wi dth 

Coispile file sequenced by default 

SEQ directive allowed In 

input stream 
Value can be specified with 
OEEiNE directive 

Control Statersent 
Product Set Forwiat 
CV option 

SI through S5 options 
NN option (no-nesting of CALLS) 



Coiiipl le file 

IF/ELSE/ENDIF directives 

IGNORE directive 

CALLC option Cconditional 



CALL) 



Other Differences 



OIFY 


?1A0IFY 


no 


yes 


yes 


no 


no 


yes 


72 


110 


100 


120 


yes 


no 


no 


yes 


y es 


no 


yes 


no (/required) 


yes 


no 


no 


yes 


no (default) 


yes 


yes 


no 


yes 


no 


no 


yes 



1. 



NADIFY 

51 - 

52 - 

53 - 

54 - 



S3 - 



NN - 



includes the following additional options - 

Do not write the *• deck name" or '•COM«fON»» on the SOURCE 

f 11 e* 

Do not expand CALL directives on tNe CQJiPILE files 

unless EDIT Is specified* 

Allow empty INPUT and OPLFILE directive files. 

(Specified as OE»naine)« Write only the deck specified 

by ••name*' and all CQHHON decks onto 

I i b r a r y « 

Allow *CREAT£ directive withotit the 

CREATE file being a deck name* Deck 

••SESQPT". 

Do not process nested CALLs.' That is* if a directive 

which would ordinarily require ex?>anslon of a COMMON 

deck appears in a COMMON 1eck» do not perform the 

expansi on* 



the new program 



first 

i^ame 



image of 
defaults 



the 
to 



2* The compile file directive* CALLC* Inhibits the expansion of 



Hl-2 
CDC - SOFTWARE ENGINEERING SERVICES 

18 DecerRber 84 
SES UserVs Handbook REV: 4A 



Ml^O DIFFERENCES BETWEEN I100IFY AND NADIFf 



the specified deck if the deck specified has already been 
expanded within the outersiost deck of the CALL nest* 

3» HAOIFY* although processing 6/12 characters* is based upon a 
63-character set HOOIFY and therefore does not handle display- 
code colons properly. 

4« HODIFY and MAOIFY neii program I i br ar1 as can be processed only 
by the program which generated them. 
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This mschanisrn defines w^en and how SES snakes user developed 
software tools available to the entire SES user' comfnunlty* The 
mechanlsia is based on the assumption that it Is beneficial to gather 
tools developed by people outside the SES organization Into a 
coiBwon* known location* 



N 1 . 1 QII^lMIIiS-Ui££.iQ£IMM£ 

The user supplied software which is asseiibled and made available 
by SES falls into the area generally considered as "tools*** It Is 
sufficiently general purpose so It Is usefiiT to people other than 
the originator* It Is comprised of SES oroceduresf programs or 
modul es • 

Software supplied by a user is totally transferable to another 
catalog* It Is not dependent on any develooer»s catalogt or any 
catalog other than the one the tool itself resides in* If the 
software being supplied is a prograw or nodule* the source code is 
supplied* along with a build procedure that Is also totally 
transferable to another catalog* The author can request the source 
remain unaccessible to other users* 

In addition to the actual software* the user submits the 
following documentation? 

A) A short description of the tool* i^iilch Is kept in an online 
directory of user supplied tools along with the supplier's 
name* location and extension* 

B) Documentation on how to use th* software* The more 
complete It is* the fewer phone calls the supplier 
receives* 

C) SES procedures contain HELP documentation that assist 
someone in using the procedure* 



Nl* 2 ail<IMS^yS£fi-SQ£IiiM£«MAlLASL£-Ii3EQy5aLSi^: 

When SES obtains user developed software* It is handled in a way 
similar to SES developed software* Procedures are collected on a 
procedure library called USRPLIB In the SES catalog*{ Binary files 
are assigned USS numbered files* and are keot In the SES catalog* 
The source for user supplied software Is collected onto a 
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semi-private SCU PL called USSPL and kept 1?^ the SES catalog. If 
the author requests that it not be accesslble» the source is kept in 
a private SES file. 

The ipajor advantage of maintaining user sup^I 1 ed software Is the 
SBS catalog is than any changes or new software are automatlcaUy 
sent to the sites receiving the regular SES updates. 



An online directory fUSSINFO) of user' supplied tools is 
maintained on the SES catalog. This file contains a short 
description of the tool provided by the developer*. This description 
is also circulated via the Advanced Systems Develoaient Productivity 
Circle and/or the SES Tools Bulletin. 

Hard copy documentation supplied by the user Is available from 
SES on request or online via TOOLDOC. 



N 1 . 4 Sy£P QEI-Q£.liS£S^iy££LI£a-iQ£IMi££ 

All correctionsf improvements or other nodlflcation to user 
supplied software are the r espons ibi 1 1 ty of the person supplying the 
software. SES does not support any user sjaplled software. 

If software supplied by a user Is standardised fit becomes a SES 
supported product) It is removed from the user supplied category. 
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